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Notational Conventions 


The notational conventions described below are used throughout this 
manual. 


UPPERCASE Characters shown in uppercase, monospace font 
must be entered in the order shown. The 
characters may be entered in either uppercase 
or lowercase. 


italics Monospaced italics indicate a metasymbol that 
may be replaced with an item that fulfills the 
tules for that symbol. Metasymbols in tables 
are not always shown in italics. 


[] Brackets indicate that the enclosed arguments or 
parameters are optional. 


{} Braces indicate that one and only one of the 
enclosed entries must be selected unless the 
entire field is also surrounded by brackets, in 
which case choosing an entry is optional. 


| The vertical bar separates options within 
brackets [] or braces {}. a) 


os An ellipsis indicates that the preceding item 
may be followed by other like items; the items 
must be separated by single spaces, but no 
additional punctuation is required. 


L---] The brackets enclosing comma and ellipsis 
indicate that the preceding item may be 
followed by other like items; the items must be 
separated by commas. 


punctuation Punctuation other than ellipses, braces, and 
brackets must be entered as shown. 


MONOSPACE TYPE This typeface represents what you type in and 
is used for examples of machine response or 
other computer displays. 
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Preface 


This manual describes how to use three Intel386™ Family utilities: the 
80386 binder (BND386), the 80386 librarian (LIB386), and the 80386 
mapper (MAP386). These utilities support the modular development 
of programs that execute on the Intel386™ Family of microprocessors. 


BND386 can create loadable, relocatable programs from modules 
produced by Intel compilers or assemblers; it can also create linkable 
modules which can then be used as input to the binder or to the 
BLD386 system builder. LIB386 can organize linkable modules into 
libraries and provides utilities for adding, deleting, and replacing 
library modules. MAP386 can generate maps from information in 
object modules. 


This manual is written for the application programmer who uses Intel 
compilers or assemblers such as C-386, ASM386, and PL/M-386. It is 
assumed that you are familiar with the rules about interfacing linked 
modules written in different languages. 


Manual Organization 


This manual has four chapters and three appendixes, as follows: 


e Chapter | describes modular program development, gives an 
overview of the Intel386™ Family utilities and summarizes the 
operation of each utility. 


e Chapter 2 describes BND386, including input and output to the 
binder, invocation, console messages, controls, the print file, and 
examples of the binder’s use. 


e Chapter 3 describes LIB386, including input and output to the 
librarian, invocation, console messages, controls and commands, 
and examples of the librarian’s use. 


e Chapter 4 describes MAP386, including input and output to the 
mapper, module processing, invocation, console messages, 
controls, maps, and examples of the mapper’s use. 


e Appendix A lists BND386 warnings and error messages with the 
causes, effects, and recovery actions if applicable. 


e Appendix B lists LIB386 warnings and error messages with the 
causes, effects, and recovery actions if applicable. 


e Appendix C lists MAP386 warnings and error messages with the 
causes, effects, and recovery actions if applicable. 


e Appendix D describes how to install the BND386, LIB386, and 
MAP386 utilities on a VMS system. 


e Appendix E describes how to install the BND386, LIB386, and 
MAP386 utilities on a DOS system. 


A glossary and index are also included and follow Appendix E. 


Related Publications 


BND386, LIB386, and MAP386 are part of Intel’s 80286/80386 
translation system. The system consists of software tools for 
developing programs that can be executed on 80386 systems operating 
in protected virtual-address mode. The following publication is of 
interest to system programmers: 


e Intel386™ Family System Builder User’s Guide, order number 
481342. 

The following publication is of interest to system and application 

programmers 

e C-386 User’s Guide, order number 481378. 
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1.2 


Chapter 1 
Introduction 


Overview 


This manual describes how to use the Intel386™ Family utilities on 
DOS and VMS operating systems. The utilities consist of the 
following software tools for modular program development: 


e The BND386 binder produces a single-task, bootloadable object 
module in Intel386" Family Object Module Format (OMF386) by 
linking modules created on Intel compilers or assemblers. 

Linking is the process of combining segments and resolving 
references. As an option, BND386 can combine linkable 
modules, which can then be used as input to BND386 or to the 
BLD386 System Builder to produce loadable modules. 


e The LIB386 librarian organizes linkable modules into libraries and 
provides utilities for adding, deleting, or replacing library 
modules. LIB386 supports many useful functions related to 
library classification, identification, and maintenance. 


e The MAP386 mapper generates a variety of listings describing the 
features of linkable or loadable object files. 


Used together to develop both application and system software, 
BND386, LIB386, and MAP386 provide the flexibility to 
accommodate a wide variety of system designs. 


Program Development 


The 80386 utilities can be most effectively used for modular program 
development, an efficient, proven approach to writing software. 

When a large program is written as a set of smaller, inter-related 
modules, errors are reduced, testing and debugging are simplified, and 
documentation is made easier. For more efficient project management 
and product updating, modules can be created by several programmers 
and can be written in different languages. 


1.3 


Figure 1-1 shows the typical development of an application module 
using BND386, LIB386, and MAP386. 
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Figure 1-1 Development of an Application Module 


Operational Summary: BND386 


BND386 produces either linkable or loadable output modules. Options 
available for use during BND386 invocation allow you to perform the 
following operations: 


Produce OMF386 bootloadable output for execution on an 80386 


Operating system 


Produce linkable output, which can be stored in object libraries 
or reprocessed with BND386 or with the BLD386 System Builder 


to create loadable output 


Perform type checking while resolving external public symbols 
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e Obtain a print file containing a segment map, module 
information, and any error messages. Error messages can also be 
directed to a separate file 


e Control the contents of the output object module 
BND386 enables you to control the contents of the output object 
module in the following ways: 


e Include or exclude debug information and public symbol 
definitions in the output module 


e Change the length of selected input segments 

e Change segment names 

e Adjust loadable module characteristics related to the operating 
system on which the modules will execute 


Chapter 2 gives additional details and examples on BND386 functions 
and use. Appendix A explains the BND386 error messages. 


Operational Summary: LIB386 


LIB386 executes both in interactive mode (for running in the 
foreground) and non-interactive mode (for running in the 
background). LIB386 enables you to perform the following 
operations: 


e Create a new library of linkable object modules 


e Update an existing library by adding, deleting, or replacing 
modules 


e Display information about each library 
e Change library names and version numbers 
e Obtain on-line summaries of the syntax of each LIB386 command 


Chapter 3 gives additional details and examples on LIB386 functions 
and use. Appendix B explains the LIB386 error messages. 
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1.5 Operational Summary: MAP386 


MAP386 enables you to perform the following operations: 


e Obtain a variety of listings, or maps, describing the contents of 
linkable or loadable input modules. The maps include the oO 
following: 


— Table Map lists descriptor names and corresponding indexes 
for Global Descriptor Tables (GDTs), Interrupt Descriptor 
Tables (IDTs), and Local Descriptor Tables (LDTs). 


— Segment Map lists names of segments in the input file and 
characteristics of each segment, such as descriptor table 
index, access type, base, descriptor privilege level, USE16/32 
attributes, align attributes, and others. 


— Gate Map lists symbolic gate names and the characteristics of 
each gate in the input file, such as descriptor table name, 
descriptor table index, gate type, and others. 


— Public Map lists public symbols in the input file and their 
characteristics, such as symbol type, word count, and logical 
address (and physical address, if applicable). 


— Symbol Map lists names of local symbols in the input file 
and characteristics of each symbol, such as symbol type, 
address, and others. 


— Task Map lists, for each task in an input file, task 
characteristics, such as initial privilege stack, flags, initial 
values of CS and EIP registers, the task’s LDT selector, and 
others. 


— Cross-Reference Map lists, for each symbol in an input file, 
the symbol’s name and type, as well as the name of the 
module containing the symbol’s public definition and the 
names of modules containing external declarations for the 
symbol. This is the only map produced for linkable modules. 


e Modify loadable or bootloadable files by selectively purging 


debug information. Oo 
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e Add information specific to the operating system to loadable files. 


e Control page formatting (e.g., page width and page length). 


Chapter 4 gives additional details and examples on MAP386 function 
and use. Appendix C explains MAP386 error messages. 
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Chapter 2 
Using the 80386 Binder 


The BND386 binder produces loadable or linkable modules by 
combining separately translated, linkable object modules, including 
modules in library files. 


You can create two kinds of loadable, single-task modules: a loadable 
module that can be loaded on an 80386 protected-mode system under 
control of the operating system or a bootloadable object module in 
Intel386™ Family Object Module Format (OMF386). (For more 
information on OMF386, refer to the Intel386™ Family System 
Builder User’s Guide, listed in the Preface.) 


As an option, you can create linkable modules. A linkable module 
can then become input to BND386 or to the BLD386 System Builder 
for the next incremental linking step or for final binding. In 
incremental linking two or more linkable modules output by a 
compiler or assembler are combined into a single linkable module. 
This linkable module then becomes input for the next incremental 
linking step or for final binding. 


Major Functions of BND386 


BND386 performs the following major functions: 


e Creates a linkable module by combining linkable input modules. 
The linkable module can be linked with other linkable modules 
through incremental linking. A linkable file generated by 
BND386 can then become input to the BLD386 System Builder. 
(For more information on the System Builder, refer to the 
Intel386"™ Family System Builder User’s Guide.) 


e Automatically selects required modules from specified libraries to 
resolve symbolic references 


e Resolves symbolic references from one input module to another. 
As an option, BND386 performs type checking while resolving 
public-external symbols 


e Creates a print file that contains the segment map and other 
information 


e Creates an OMF386 bootloadable module targeted for an 80386 


operating system. O 


2.2 Input and Output 


BND386 accepts linkable modules from either 80286 or 80386 
software development products, including linkable modules produced 
by compilers or assemblers such as FORTRAN-286 and PL/M-386, 
linkable files output by BND286 or BND386, library files created by 
LIB286 or LIB386, or export files produced by BLD286 or the 
BLD386 System Builder containing entry points to the operating 
system. Export files are treated as ordinary linkable files and so are 
not discussed separately in this manual. (For more information on 
export files, refer to the Intel386™ Family System Builder User’s 
Guide.) 

BND386 does not accept incrementally built files created with 
BLD286 or the BLD386 System Builder. we) 


Input files are processed in the same order in which they are specified 
on the BND386 invocation line. 


Each input file can be a library file or a non-library file, and each 
one can be followed by a list of modules. Both factors determine how 
BND386 processes the input file. 


A library file contains one or more object modules as well as control 
information. A module in a library file is processed if the module is 
explicitly listed on the invocation line. If a module list is not 
specified for a library file, the binder only processes modules if 
previously processed modules contain one or more unresolved 
externals. Then the binder scans the library file for modules 
containing public symbols that match the unresolved externals. Each 
such module is processed when found. The scanning continues until 
the modules in the library cannot satisfy any more unresolved 
externals, including any more unresolved externals encountered while 
processing modules from the library. 
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As output, BND386 creates either an OMF386 bootloadable file 
targeted for an 80386 operating system, or a linkable file that can 
become input to BND386 or the BLD386 System Builder in a 
subsequent step. The BND386 RCONFIGURE control produces an 

oO OMF386 bootloadable file. The LOAD control creates a single-task 
loadable file that can be loaded on an 80386 protected-mode system 
under the control of the operating system. 


In addition, BND386 creates a print file that contains a segment map 
and other information. 


Figure 2-1 illustrates BND386 input and output. 


LINKABLE 
FILE 


LOADABLE 
FILE 
LIBRARIES 
MESSAGES PRINT 
Ea 


Figure 2-1 BND386 Input and Output 


LINKABLE 
FILE(S) 


INVOCATION 
LINE 


2.3 BND386 Processing 
When BND386 creates a linkable or a loadable file, it performs the 
Oo following functions, which are not directed by invocation controls: 
° Segment combination 
e Reference resolution 


e  Fix-up processing 
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2.4.1 


2-4 


e Descriptor table creation (only for loadable files) 
e Task state segment (TSS) creation (only for loadable files) 


These functions are described in the following sections. 


Segment and Segment Combination 


The 80386 processor uses a segmented memory scheme in which 
program instructions and data are divided into logical units, or 
segments. There are two kinds of segments: USE16 and USE32. A 
USE16 segment is output from 80286 utilities, compilers, and 
assemblers and contains up to 64K bytes of code, data, or stack area. 
A USE32 segment is output from 80386 utilities, compilers, and 
assemblers and contains up to 4 gigabytes of code, data, or stack area. 
The ASM386 assembler can output both USE16 and USE32 segments. 


Intel compilers and assemblers support the concept of logical segments 
and can produce object code that is already segmented. BND386 uses 
the output produced by a compiler or assembler to take segmentation 
one step further, combining segments with the same name and similar 
characteristics. Because similar segments from separately translated 
modules can be merged, the program as a whole consists of fewer 
segments and becomes more efficient. 


BND386 combines segments of the same kind: code, data, or stack (see 
Figure 2-2). During processing, BND386 checks the characteristics of 
each input segment and combines segments that satisfy its 
combination criteria. The following sections describe these 
combination criteria in detail. 


Segment Attributes 


The code, data, stack and other segments that constitute a translated 
program have a variety of characteristics, such as symbolic name, size, 
and access rights. These characteristics are based in part on the kind 
of information in the segment and on the features of the 
programming language in which the program is written. 
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Oo 


The characteristics of a segment determine whether BND386 combines 
it with other segments in modules processed during the same BND386 
invocation. If the characteristics of two or more segments satisfy the 
combination criteria, BND386 combines them into one segment. The 
characteristics of the two original segments determine the 
characteristics of the resulting segment. 


MODULE 1 


BND386 
BINDER 


MODULE 3 


Figure 2-2 BND386 Segment Combination 


The following segment characteristics affect the process of segment 
combination: 


e Segment name 
e USE attribute 
e ~=Length (size) 
e Access rights 
e Combine type 
e = Align attribute 
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2.4.3 


2.4.4 


2.4.5 
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Segment Names 


The name of a segment is the symbolic name assigned by the 
programmer in ASM286 or ASM386 programs or by the compiler in 
high-level-language programs. For high-level-language programs, the 
compiler assigns segment names according to the model of 
segmentation used. Refer to the appropriate Intel compiler manual 
for the names assigned to segments compiled under various 
segmentation models. 


USE Attribute 


USE16 segments have up to 64K bytes; USE32 segments have up to 4 
gigabytes. A USE16 segment cannot be combined with a USE32 
segment that contains code (that is, has an "execute" access right). A 
USE32 segment that does not have "execute" access rights can be 
combined with a USE16 segment as long as the other combination 
criteria are met. The resulting segment is a USE16 segment of up to 
64K bytes. 


Segment Length 


Segment length is measured in bytes. The length of a given segment 
depends on how much and what kind of information it contains. 
These factors in turn depend on the design of the program or the 
individual module. 


Access Rights 
Each segment in a program is assigned one of the following access 
rights during translation: 
e Read-only (RO) 
e Read-write (RW) 
e  Execute-only (EO) 
e  Execute-read (ER) 


Code, data, and stack segments may be assigned access rights as 
follows: 
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e Code segments: EO or ER access 


e Data segments: RO or RW access 


e Stack segments: RW access 


Combine Type 


Each segment in a program is assigned a combine type during 
compilation. Segments can have the following combine types: 


Combine Type 
stack 


no-combine 


common 


blank common 


normal 


data/stack combined 


debug 
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Segment Description 
All stack segments 


Code or data segments cannot be combined: for 
example, ASM386 segments that are not 
PUBLIC and PL/M-286 segments compiled 
under the LARGE model 


Segments contain named FORTRAN-286 
common blocks 


Segments contain unnamed FORTRAN-286 
common blocks 


Code or data segments can be combined and do 
not contain FORTRAN-286 common blocks: for 
example, ASM386 segments that are PUBLIC or 
segments created by PL/M-386 


A segment resulting from the combination of 
normal data segments and stack segments. This 
attribute is assigned only by BND286 or by 
BND386, not by a compiler or assembler 


Segments that contain information for 
debuggers. They are combined like normal 
segments 
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2.4.8 


2.4.9 


Align Attribute 


The align attribute specifies the boundary to which a segment is 
aligned. A byte-aligned segment can be placed anywhere in memory. 
A word-aligned segment is placed at an even address, and so on. 
During segment combination, if necessary, BND386 inserts gaps 
between segments to comply with alignment requirements. 


Privilege Level 


Each segment has a privilege level between 0 and 3. 80386 compilers 
and assemblers set the privilege level of all segments to 3. BND386 
creates a single task with a single privilege level, and all segments 
have the effective privilege level, as determined by the 
TASKPRIVILEGE control, regardless of original privilege level. The 
exception is gate descriptors exported from the BLD386 System 
Builder, which retain their original privilege level. 


Criteria for Segment Combination 


BND386 combines two segments if all the following criteria are met: 
e Both segments have the same name. 

e Both segments have compatible access rights (see Table 2-1). 

e Both segments have compatible USE attributes. 

e Both segments have compatible combine types. 

The combine types of two segments are compatible if they fall into 
one of the following categories: 


e Both segments have the same combine type and neither is of the 
type no-combine. 


e One segment is a data segment of combine type normal and one 
segment is a stack segment. 


e One segment is a data/stack combined (DSC) segment and the 
other segment is either a stack segment or a data segment of 
combine type normal. 
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Table 2-1 Matrix of Access Rights Assignments for Combined Segments 


Original RO RW EO ER 
Segments 


RO = Read only 
RW = Read-write 
EO = Execute only 
ER = Execute-read 


2.4.10 Attributes of the Resulting Segment 


The attributes of the original segments determine the attributes of the 
combined segment. The combined segment is assigned attributes as 
follows: 


e The name of the original segments 


e The combine type of the original segments, if both were of the 
same combine type. 


e The DSC combine type, if one segment was a normal data 
segment which had an access of RW and was PUBLIC and the 
other was a stack segment or a DSC segment 


e The privilege level set by the TASKPRIVILEGE control 


The combined segment is also assigned access rights based on the 
access rights of the original segments (see Table 2-1). 


Code segments with different USE attributes cannot be combined. 


Data segments with different USE attributes are assigned the USE16 
attribute when combined. 
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2.4.11 Length of the Resulting Segment 


The length of the combined segment depends on the lengths, combine 
types, and alignment attributes of the original segments, as explained 
below: oO 


e When two normal segments are combined, BND386 starts by 
making the length of the combined segment the sum of the 
lengths of the original segments. Then BND386 adds bytes 
between segments, if necessary, to align the second segment 
according to its alignment attribute. The combined segment may 
therefore be longer than the sum of the lengths of the original 
segments. 


e When two stack segments are combined, BND386 does not 
perform offset relocation or alignment. The combined segment is 
as long as the sum of the lengths of the original segments. 


e When two common segments are combined, BND386 expects the 
segments to be of the same length and does not perform offset 
relocation. The combined segment is as long as either one of the 
original segments. An error is issued if the segments are not of 


the same length. i) 


e When two blank common segments are combined, BND386 makes 
the combined segment as long as the longer of the two segments - 
and does not perform relocation or offsets. 


e When two DSC segments are combined, BND386 treats the normal 
portions as normal segments and the stack portions as stack 
segments. As a result, the combined DSC segment is the sum of 
the lengths of the original segments, plus any extra bytes added 
to align the normal portions according to their alignment 
attribute. 


BND386 can add up to three extra bytes to segments, in addition to 

the gaps introduced for alignment. This length adjustment is called 

padding. BND386 adds an extra byte to segments with both the 

USE16 attribute and RO, RW, or ER access rights, so that 16-bit 

word references to the last byte in the segment remain valid. 

BND386 adds three extra bytes to segments with both the USE32 oO 
attribute and RO, RW, or ER access rights, so that 32-bit word 

references to the last byte in the segment remain valid. 
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BND386 adds bytes to the data portion of a DSC segment and leaves 
the stack size unchanged. The data portion of a USE16 DSC segment 
must have an even length. The data portion of a USE32 DSC segment 
must be divisible by four. If adding bytes makes the data portion of 
a USE16 segment an odd length or makes the data portion of a USE32 
segment indivisible by four, BND386 pads the data portion with one 
or more bytes to make up the difference. Note that because the data 
portion of a DSC segment is even or divisible by four, its effective 
stack pointer is also even or divisible by four. 


Reference Resolution 


BND386 attempts to resolve symbolic references among input 
modules. A symbolic reference is a declaration of a variable, 
procedure, or label, either external or public. Names of variables, 
procedures, and labels are called symbols. References are resolved 
when BND386 finds a public declaration in the input modules for 
each external declaration of the same symbol. 


When an external declaration such as an extern in C or a common in 
ANSI Fortran has no matching public, the compiler or assembler gives 
the total size of the symbol. BND386 then allocates the maximum size 
of external matching symbols in the input and initializes the allocated 
area to zero. In effect, this procedure generates a public declaration 
to resolve the externals. 


An unresolved external causes a warning when a loadable module is 
built and the reference is left undefined. However, unresolved 
externals are allowed in loadable modules, because in some operating 
systems they can be resolved by the loader at load-time. Multiple 
public symbols with the same name cause a warning. 


Figure 2-3 shows a resolved public-external procedure pair in two 
linkable input modules, one of them a main module. 
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MAIN@MOD: DO 4 BUFFSHANDLER: DO 4 


(= 

DECLARE BUFF (5) BYTES | Foo: PROCEDURE (BUFFERSADDR) PUBLIC: 
oe et aN As 
| FOO: PROCEDURE (BUFPTR) EXTERNALs]  '———————————— ~~ 
|] ‘DECLARE BUFPTR POINTERS DECLARE BUFFER#ADDR POINTER: 
| | 
LS. Se a ees 7 

END FO0s 
CALL FOO (BUFF) 
END BUFFSHANDLERS 
END MAINSMO0Ds 
m-0551 
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Figure 2-3 A Resolved Public-External Procedure Pair 


Fix-up Processing 


Input segments may contain references to an unresolved external or to 
a logical address, which consists of a segment selector and an offset in 
the segment. The compiler or assembler passes fix-up information on 
each reference to BND386. BND386 adjusts the offsets of logical 
addresses in the fix-up information to reflect segment combination. 


In generating a linkable module, BND386 performs the following 
fix-up operations: 


e Replaces satisfied external symbol names with the logical 
addresses of the corresponding public symbols. 


e Adjusts all logical addresses referring to the combined segments 
to reflect segment combinations. 
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In generating a loadable module, BND386 processes the fix-ups as 
follows: 


e =6If the target is specified by an external symbol that is satisfied by 
a matching public symbol (either from the input or allocation by 
BND386), the external symbol is replaced by the logical address 
of the matching public symbol. 


e If the target refers to an unresolved symbol, the fix-up is output 
to the loadable file, a warning is issued, and the fix-up is not 
applied. Fix-ups are output to the loadable file in the section of 
the object that contains relocation information. 


e If the target is specified by a gate, the fix-up is applied using the 
gate selector. 


e 6 If the target is specified by a global descriptor table (GDT) 
selector [internal name], the fix-up is applied using the GDT 
selector. 


Descriptor Table Creation 


BND386 produces a descriptor table for loadable output. The table is 
either in the format of a final LDT (local descriptor table) ready to be 
loaded by the loader or in the format of a relocatable descriptor table, 
in which the entry number of each descriptor is not fixed and is set 
at load time. When the table is not necessarily final, BND386 adds 
relocation information to the object file. This procedure allows the 
loader to update each selector reference. 


Task State Segment Creation 


A BND386 loadable output module contains the basic elements of a 
single task. In each loadable module, BND386 provides information 
that enables the loader to construct a task state segment (TSS) and an 
LDT. 
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2.9 Invoking BND386 


2.9.1 DOS Invocation Syntax oO 


To invoke BND386 on a DOS operating system, use the following 
syntax: 


BND386 input-list [controls] 
Where: 


input-list is one or more linkable modules or object 
library modules to be processed by BND386. 
For DOS, the modules are specified as follows: 


filename| {module-list 
, eae 


filename(*) can replace the complete list of 

linkable or library modules in the file called 

filename. BND386 then processes all modules oO 
in a file. 


controls consists of one or more of the specifications 
defined in Section 2.13. 


BND386 processes files in the input list in the order in which they are 
specified. Therefore, only unresolved external symbols that come 
before a library file can be resolved by the public symbols in the 
library. 


If modules are specified with a library file in the invocation line, 
BND386 processes specified modules only. 


If filename(*) is specified with a library file in the invocation line, 
BND386 processes all modules in the library. 


* 
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If no modules are specified with a library file in the invocation line, 
BND386 processes that library file only if previously processed 
modules contained at least one unresolved external. The library is 
scanned for modules containing public symbols that match unresolved 
externals and each such module is processed as if it were specified. 
The process continues until the modules in the library cannot satisfy 
any more unresolved externals (including externals encountered while 
processing modules from the library). 


If no modules are specified with a linkable file in the invocation line, 
BND386 processes all modules in the file exactly as if you had used 
filename(*). 


BND386 issues an error message when it finds duplicate module 
names. 


The input list can be omitted from the invocation command if the list 
is specified in at least one control file. 


You can continue the invocation line on additional lines by entering 
the ampersand (&) before you enter the line terminator. The 
continuation line then appears automatically with the DOS system 
prompt character. 
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2.9.2 VMS Invocation Syntax 


To invoke BND386 on a VMS operating system, use the following 


syntax: . 


BND386[/controls] input-list 
Where: 


input-list ~ is one or more linkable modules or object 
library modules to be processed by BND386. 
For VMS, the modules are specified as follows: 


"filename| {module-list)|" 
a jee 


filename(*) can replace the complete list of 
linkable or library modules in the file called 
filename. BND386 then processes all modules 
in a file. 


On a VMS system, the file name and module Oo 
list must be enclosed in double quotation marks 


(") 
controls consists of one or more of the specifications 
defined in Section 2.13. 


BND386 processes files in the input list in the order in which they are 
specified. Therefore, only unresolved external symbols that come 
before a library file can be resolved by the public symbols in the 
library. 


If modules are specified with a library file in the invocation line, 
BND386 processes specified modules only. 


If filename(*) is specified with a library file in the invocation line, 
BND386 processes all modules in the library. 


*) 
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If no modules are specified with a library file in the invocation line, 
BND386 processes that library file only if previously processed 
modules contained at least one unresolved external. The library is 
scanned for modules containing public symbols that match unresolved 

#) externals and each such module is processed as if it were specified. 
The process continues until the modules in the library cannot satisfy 
any more unresolved externals (including externals encountered while 
processing modules from the library). 


If no modules are specified with a linkable file in the invocation line, 
BND386 processes all modules in the file exactly as if you had used 
filename(*). 


BND386 issues an error message when it finds duplicate module 
names. 


The input list can be omitted from the invocation command if the list 
is specified in at least one control file. 


You can continue the invocation line on additional lines by entering 
the ampersand (&) before you enter the line terminator. The 

 #) continuation line then appears automatically with the VMS system 
prompt character. 


2.10 Control Files 


The BND386 invocation line is simplified when you can use the 
CONTROLFILE control to include a control file. A control file is a text 
file containing controls, file names, or controls and file names that 
would normally appear in the invocation line. For example, instead 
of listing five controls in the BND386 invocation line, you can place 
those controls in a single control file and then invoke the control file 
in place of all five controls. 


Oo 2.10.1 Using a Control File on DOS 


To include a control file in the BND386 invocation line on a DOS 
operating system, use the following syntax: 


BND386 CONTROLFILE (filename[,...]) 
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Where: 


filename is the name of the control file containing 
controls, file names, or controls and file names 
for the input list. You cannot nest control files: 
that is, the CONTROLFILE control cannot appear 
in a control file. 


A control file that contains only controls can be specified in any 
position in the control list. A control file that contains only file 
names for the input list can be specified in any position in the input 
list. 


In a control file that contains both input files and controls, input files 
must come before controls. In this case, specify the control file as 
part of the input list. 


The following example shows how to specify the CONTROLFILE 
control in an input list that contains the files named in CF1.DAT: 


BND386 MOD.OBJ, CONTROLFILE (CF1.DAT) DEBUG 


Within a control file, use a semicolon before a comment. Use the 
ampersand (&) to continue to the next line. When the line terminator 
comes before the ampersand, it is treated as if it were a blank space. 
BND386 ignores characters between a semicolon or continuation 
character and the line terminator. Lines in a control file cannot 
exceed 120 characters in length. 


This example control file contains only file names for the input list: 


util. lib, j utility library& 
system. Lib 3 system Library 


This example control file contains the last file names for the input list 
and controls for the control list: 


util. lib, j utility library& 
system. lib 7 system library& 
lo& ; loadable module& 
ep& ; directs error messages& 


to the specified print& 
file specified& 
oj (lbt.sys) ; Mame output file 


oo 
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oO 


oO 


2.10.2 Using a Control File on VMS 


There are two ways to include a control file in the BND386 
invocation line on a VMS operating system, depending on whether the 

oO control file contains only controls or it contains file names for the 
input list. 


To include a control file that contains controls only, use the following 
syntax on the BND386 invocation line: 


BND386/CONTROLFILE = (filename[,...]) 


Where: 

filename is the name of the control file containing 
controls. You cannot nest control files: that is, 
the CONTROLFILE control cannot appear ina 
control file. When you are specifying a single 
control file, you can drop the parentheses 
around filename. 

To include a control file that contains only file names for the input 

#) list or file names and controls, use the following syntax on the 


BND386 invocation line: 


BND386 "“CONTROLFILE (filename[,...])" 
Where 


filename is the name of the control file containing file 
names for the input list. Note that you must 
enclose both the CONTROLFILE control and the 
file name or names in double quotation marks 
(") and enclose the file name in parentheses. 


A control file that contains only controls can be specified in any 
position in the control list. A control file that contains only file 
names for the input list can be specified in any position in the input 


list. 

#) In a control file that contains both input files and controls, input files 
must come before controls. In this case, specify the control file in the 
input list. 


Using the 80386 Binder 2-19 


The following example shows how to specify the CONTROLFILE 
control in an input list that contains the files named in CF1.DAT: 


BND386/DEBUG MOD.OBJ, "CONTROLFILE (CF1.DAT)" Oo 


VMS NOTE 


On VMS systems, BND386 controls can be abbreviated 
according to the VMS notation if their first four characters are 
unique. Otherwise, the control name must be used in full or 
abbreviated according to Table 2-4. 


For example, since the first two characters of the ERRORPRINT 
control are unique, the control can be abbreviated either as 
/ER or as /EP, the BND386 abbreviation shown in Table 2-4. 
VMS systems do not consider the full control name and the 
BND386 abbreviation in Table 2-4 to be the same control. 
Therefore, do not mix control abbreviations and full control 
names on the same invocation line. 


Within a control file, use a semicolon before a comment. Use the oO 
ampersand (&) to continue to the next line. When the line terminator 

comes before the ampersand, it is treated as if it were a blank space. 

BND386 ignores characters between a semicolon or continuation 

character and the line terminator. Lines in a control file cannot 

exceed 120 characters in length. 


This example control file contains control files for the input list only: 


util.lib, ; utility library& 
system. lib 7 system library 


This example control file contains the last file names for the input list 
and controls for the control list: 


util. lib, utility library& 

system. Lib 7 system Library& 

lo& ; loadable module& oO 
eps directs error messages& 

to the specified print& 

file speci fied& 

oj (lbt.sys) 7 Name output file 
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2.11 


2.11.1 


Oo 


2.11.2 


BND386 Defaults 


Output File Names 


If not specified in the invocation line, output file names are assigned 
by default, as follows: 


The file that contains the output loadable module has the same 
name as the first input file. Under DOS, the output has no 
extension. Under VMS, the output has the file type .DAT. 


The file that contains the output linkable module has the same 
input file name as the first input file, with extension, or file 
type, .LNK. 


The print file has the same name as the output object file, with 
extension, or file type, .MP1. 


Controls 


If no controls are specified on the invocation line, BND386 does the 
following: 


It creates a loadable output module. The output module is placed 
in a file having the same file name as the first input module 
listed in the invocation line. Under DOS, the output has no 
extension. Under VMS, the output has the file type .DAT. 


It creates a print file with the same name as the object file, with 
extension, or file type, .MP1. 


It performs type checking between public and external symbols in 
input modules and includes symbol type information in output 
modules. 


It includes debug information in output modules (if this 
information is in the input modules). 


Some BND386 controls imply that other controls are in effect by 
default. Refer to Section 2.13 and individual control entries later in 
this chapter for more information on default implementation. 
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2.12 Console Messages 


2-22 


BND386 displays console messages when signing on and signing off, 
as well as during processing. During processing, BND386 issues 
warnings, error messages, or fatal error messages if it encounters any 
problems. 


Fatal error messages are always displayed at the console, even if you 
have directed error messages to an error print file with the 
ERRORPRINT control. 


When you invoke BND386 on a DOS or VMS operating system, the 
binder displays the following sign-on message: 


system-id 
80386 BINDER, Vx.y 
Copyright years Intel Corporation 


Where: 

system-id is the identifier and version number of the 
operating system. 

Vx.y is the BND386 version number. 

years: is the copyright year or years. 


When BND386 encounters a fatal error condition, an error message 
and sign-off message are displayed at the console. The sign-off 
message is as follows: 

PROCESSING ABORTED 


See Appendix A for additional information about error conditions. 
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When BND386 does not encounter a fatal error condition, BND386 
signs off when you exit or after processing is complete, as follows: 


PROCESSING COMPLETED.n WARNINGS ,m ERRORS 
Where: 


n and m represent the number of warning and nonfatal 
error conditions encountered during processing. 
You can use the ERRORPRINT control to display 
warning and error messages on the console or 
direct them to a file. 


2.13 BND386 Controls 


BND386 controls determine the extent and characteristics of BND386 
output. Some controls determine what kind of output is produced: a 
print file, an object file, or a file containing error messages. Other 
controls affect the characteristics of the output object module: size of 
segments, privilege level, whether debug information is included, and 
other features. 


Target controls determine the type of object file that BND386 is to 
produce. NOLOAD produces a linkable output module. LOAD produces a 
loadable module. RCONFIGURE produces an OMF386 bootloadable 
module specifically intended for an 80386 operating system. 


Table 2-2 summarizes BND386 controls for DOS operating systems. 
Table 2-3 summarizes BND386 controls for VMS operating systems. 
The default column shows the condition in effect when the control is 
not specified. When an invocation contains duplicate control 
specifications, BND386 processes only the rightmost specification on 
the invocation line. 
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Each BND386 control is listed alphabetically and described in detail in 
the section following Table 2-4. In the detailed descriptions, the 
controls labeled DOS are used for DOS command lines as well as for 
DOS and VMS control files. The controls labeled VMS are used for 
VMS command lines only. 


Table 2-4 lists abbreviations of BND386 controls. These abbreviations 
are repeated in the following sections describing each control in 
detail. 


Table 2-2 BND386 Controls for DOS Operating Systems 


Command Line Syntax Description Default 


COMPATIBLE87 
NOCOMPATIBLE87 


Sets numeric coprocessor to | NOCOMPATIBLE87 
8087- or 80387-compatible 
mode 


CONTROLFILE (filename|....]) Specifies file for input 
elements 
DEBUG Retains or removes debug DEBUG 
NODEBUG information 
DEFAULTPAGES Fixes segments in memory 
[seg-name|,...])] 
ERRORPRINT [(filename)} Creates or does not create | NOERRORPRINT 
NOERRORPRINT error print file 
FIXEDPAGES [(seg-name|,...])] | Fixes segments in memory 
for real-time applications 
INT286 [mod-name|,...])] Provides interface control to | None 
80286 programs 


oO 
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Table 2-2 BND386 Controls for DOS Operating Systems (continued) 


Command Line Syntax 


LDTSIZE ([+]number) 


NAME (mod-name) 


OBJECT [(filename)} 
NOOBJECT 


PRINT [(filename)] 
NOPRINT 


PUBLICS [EXCEPT 
(symbol[,...])] 
NOPUBLICS [EXCEPT 
(symboll,...])] 


PURE 
NOPURE 
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Description Default 


Extends the limit of local None 
descriptor table in loadable 

output module 

Creates loadable (LOAD) or | LOAD 

linkable (NOLOAD) module 

Names linkable output First input-mod- 
module name 


Creates and names or First input-filename 
suppresses creation of 
object module output 


Verifies input object module | MOD386 
meets 80387 requirements 

(MOD376) or 80386 

requirements (MOD386) 

Creates and names or PRINT 
suppresses creation of print 

file 

Retains or removes public PUBLICS 
symbol definitions in linkable 

output modules 


Fixes alignment boundary of | NOPURE 
DATA segment, enabling 

sharing of text between 

programs under the UNIX 

operating system 
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Table 2-2 BND386 Controls for DOS Operating Systems (continued) 


Command Line Syntax Description Default 
RCONFIGURE [(DYNAMICMEM | Produces loadable output 
(memory-range))] configured for an 80386 
operating system 
RELDESC Generates temporary Final LDT 
descriptor table 
RENAMESEG (o/d-seg-name TO | Renames an input segment 
new-seg-name]....]) 


RESERVE (number1 TO Specified numbers not 
number2|....]) assigned as local descriptor 
table selectors 


SEGSIZE (seg-name ([+/- Changes length of stack or 

]size)[,...]) data segment in output 
object module by specified 
size 


TASKPRIVILEGE (number) Sets privilege level of task TP(3) 
TYPE Enables or suppresses type 
NOTYPE checking 
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Table 2-3 BND386 Controls for VMS Operating Systems 


Command Line Syntax Description Default 


o COMPATIBLE87 Sets numeric coprocessor to |} NOCOMPATIBLE87 
NOCOMPATIBLE87 8087 or 80387 compatible 
. mode 


CONTROLFILE = filename Specifies file for input 
CONTROLFILE = (filenamef{,...] | elements 
DEBUG Retains or removes debug DEBUG 
NODEBUG information 
DEFAULTPAGES [= (seg- Fixes segments in memory 
name|,...])] 
ERRORPRINT [= filename] Creates or does not create | NOERRORPRINT 
NOERRORPRINT error print file 
FIXEDPAGES [= (seg- Fixes segments in memory 
namef{,...])] for real-time applications 
INT286 [= (mod-name|,...])] Provides interface control to 
80286 programs 
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Table 2-3 BND386 Controls for VMS Operating Systems (continued) 


Command Line Syntax Description Default 


LDTSIZE = "+number' or Extends the limit of local 
LDTSIZE = number descriptor table in loadable 
output module 
LOAD Creates loadable (LOAD) or | LOAD 
NOLOAD linkable (NOLOAD) module 
MOD376 Names linkable output First input-mod- 
MOD386 module name.LNK 
NAME = mod-name Creates and names or First input- 
suppresses creation of filename.DAT 
object module output 
OBJECT [= filename] Verifies input object module | MOD386 
NOOBJECT meets 80376 requirements 
(MOD376) or 80386 
requirements (MOD386) 
PRINT [= filename] Creates and names or PRINT 
NOPRINT suppresses creation of print 
file 
PUBLICS [/EXCEPT = PUBLICS 
(symbol{,...])] 


(symbol[,...])] 
PURE NOPURE 
NOPURE 


NOPUBLICS [/EXCEPT = 
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Oo 


Retains or removes selected 
public symbol definitions in 
linkable output modules 


Fixes alignment boundary of 
DATA segment, enabling 
sharing of text between 
programs under the UNIX 
operating system. 


Table 2-3 BND386 Controls for VMS Operating Systems (continued) 


Command Line Syntax Description Default 

RCONFIGURE [= Produces loadable output 

“"DYNAMICMEM (memory- configured for an 80386 

range)"] operating system 

RELDESC Generates temporary Final LDT 
descriptor table 

RENAMESEG = ("old-seg-name | Renames input segments 

TO new-seg-name'"....] 


RESERVE = (“number? TO Does not assign numbers in 


number2"(,...]) the specified range as local 
descriptor table selectors 


SEGSIZE = ("seg-name ([+/- Changes length of stack or 

]size"[,...]) data segment in output 
object module by specified 
size 


TASKPRIVILEGE = number Sets privilege level of task TP=3 
being created 

TYPE Enables or suppresses type 

NOTYPE checking 


Using the 80386 Binder 2-29 


VMS NOTE 


On VMS systems, BND386 controls can be abbreviated 
according to the VMS notation if their first four characters are 
unique. Otherwise, the control name must be used in full or 
abbreviated according to Table 2-4. 


For example, since the first two characters of the ERRORPRINT 
control are unique, the control can be abbreviated either as 
/ER or as /EP, the BND386 abbreviation shown in Table 2-4. 
VMS systems do not consider the full control name and the 
BND386 abbreviation in Table 2-4 to be the same control. 
Therefore, do not mix control abbreviations and full control 
names on the same invocation line. 


Table 2-4 Standard Abbreviations for BND386 Controls 


Control 


COMPATIBLE87 
CONTROLFILE 
DEBUG 
DEFAULTPAGES 
ERRORPRINT 
FIXEDPAGES 
LDTSIZE 

LOAD 

MOD376 
MOD386 

NAME 
NOCOMPATIBLE 
NODEBUG 
NOERRORPRINT 
NOLOAD 
NOOBJECT 
NOPRINT 
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Control 


NOPUBLICS 
EXCEPT 
NOERRORPRINT 
NOPURE 
NOTYPE 
OBJECT 

PRINT 

PUBLICS 
EXCEPT 

PURE 
RCONFIGURE 
DYNAMICMEM 
RELDESG 
RENAMESEG 
RESERVE 
SEGSIZE 
TASKPRIVILEGE 
TYPE 
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COMPATIBLE87/NOCOMPATIBLE87 


Sets numeric coprocessor to 
8087- or 80387-compatible mode 


we) Syntax 


DOS: COMPATIBLE87 
NOCOMPATIBLE87 


VMS: /COMPATIBLE87 
/NOCOMPATIBLE87 


Abbreviations 
cP 


NOCP 


Oo Default 


NOCOMPATIBLE87 


Description 


The COMPATIBLE87 control flags the object output module, so the 
loader can switch the numeric coprocessor to work in 8087- or 
80387-compatible mode. If the module requires 8087 semantics but 
the system is equipped with an 80387, the operating system must 
supply the necessary conversion software. 


The default NOCOMPATIBLE87 control causes the numeric coprocessor 
to work in 80387-compatible mode. 
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COMPATIBLE87/NOCOMPATIBLE87 (continued) 
Examples 


In the following examples, the loader switches the numeric 
coprocessor to work in 8087-compatible mode. re) 


DOS: BND386 MOD.OBJ COMPATIBLE87 


VMS: _ BND386/COMPATIBLE87 MOD .OBJ 
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CONTROLFILE 
Specifies file for 
input elements 


oO Syntax 


DOS: CONTROLFILE (filename[,...]) 


VMS: /CONTROLFILE = (filename[,...]) 


Abbreviation 


CF 


Default 


CONTROLFILE is not in effect. 
© Description 


The CONTROLFILE control reads invocation specifications from a 
control file. Invocation specifications can include input files and 
invocation controls, but cannot include partial controls or partial 
input-list elements. BND386 returns to the command line when ‘3 
encounters the end of the control file. 


A control file cannot contain the CONTROLFILE control. 

On VMS systems, when control files are part of the input list, the 
entire control file control must be enclosed in double quotation marks 
("). Also, the parentheses enclosing the file name can be dropped 
when a single file name is specified. 


oO See Section 2.10 for the content and format of control files. 
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CONTROLFILE (continued) 


Examples 
In the following examples, control file CNTL1.DAT contains 
UTIL.LIB and SYSTEM.LIB, and control file CNTL2.DAT contains 
PRINT(SAMPLE.MAP) and DEBUG. The following pairs of oO 
invocation lines do the same thing: 


DOS: BND386 SAMPLE.OBJ, CF(CNTL2.DAT) CF(CNTL1.DAT) 


BND386 SAMPLE.OBJ, UTIL.LIB, SYSTEM.LIB PRINT(SAMPLE.MAP) DEBUG 


VMS: 8BND386/CF = CNTL.2.DAT SAMPLE.OBJ,"CF(CNTL1.DAT)" 


BND386/PRINT = SAMPLE.MAP/DEBUG SAMPLE.OBJ,UTIL.LIB, SYSTEM.LIB 


For additional examples, see Chapter 4 on the mapper 


2-34 Using the 80386 Binder 


DEBUG/NODEBUG 


Retains or removes 
debug information 


oO Syntax 


DOS: 


VMS: 


DEBUG 
NODEBUG 


/DEBUG 
/NODEBUG 


Abbreviations 


DB 


NODB 


Default 


DEBUG 


Description 


The DEBUG control places information used by symbolic debuggers in 
the output object module. Debug information consists of the 
following: 


e Symbolic names and source or listing line numbers generated by 
compilers or assemblers 


e Public and external symbols plus type and module information 
formatted by BND386 for debuggers 


The NODEBUG control purges symbolic debugging information from the 
output module. 


Debug information is needed by MAP386, so you can leave the 
information in place and purge it with MAP386 later in the 
development process. 
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DEBUG/NODEBUG (continued) 
Examples 


I. In the following examples, compiler or assembler output for 
symbolic debugging is included in the output linkable module in 


DOS: 


VMS: 


DOS: 


VMS: 
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the file MODI.LNK. 
BND386 MO01.0BJ, MO02.0BJ NOLOAD DEBUG 


BND386/NOLOAD/DEBUG MOD1.0BJ MOD2.0BJ 


2. In the following examples, debugging information is removed 
from the output loadable module in the file MOD3 (on DOS) and 


MOD3.DAT (on VMS). 
BND386 MOD3.0BJ, MOD4.0BJ NODEBUG 


BND386/NODEBUG MOD3.OBJ, MOD4.0BJ 
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DEFAULTPAGES 


Fixes segments 
in memory 


oO Syntax 


DOS: DEFAULTPAGES [(seg-name [,...])] 


VMS: /DEFAULTPAGES [= (seg-name[,...])] 


Abbreviation 


DF 


Default 


DEFAULTPAGES is not in effect. 


Oo Description 


The DEFAULTPAGES control allows the operating system to determine 
which segments are to be paged, according to the default in effect for 
the job. Use this feature with modules to be loaded on an 80386 
operating system. For any other operating system, refer to the 
documentation for your target operating system to verify that this 
feature is supported. 


When seg-name is not specified, all segments are assumed. 


NOTE 


DEFAULTPAGES is effective only when LOAD is in effect. 
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DEFAULTPAGES (continued) 
Examples 


In the following examples, the segment named SEG-NAME is paged 
according to the default in effect for the job. . 


DOS: 8ND386 MOD1.0BJ LOAD DEFAULTPAGES (SEG-NAME) 


VMS: BND386/LOAD/DEFAULTPAGES = SEG-NAME MOD1.OBJ 
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ERRORPRINT/NOERRORPRINT 


Creates or does not create 
an error print file 


oO Syntax 


DOS: ERRORPRINT [(filename) ] 
NOERRORPRINT 


VMS: /ERRORPRINT [= filename] 
/NOERRORPRINT 


Abbreviations 
EP 


NOEP 


oO Default 


NOERRORPRINT 


Description 
The ERRORPRINT control directs error messages to one of the 
following: 
e The standard output device, if filename is not specified 
e =6The file called filename 


The NOERRORPRINT control does not produce a file containing error 
messages; error messages appear in the normal print file. 


No matter which of the two controls is in effect, fatal error messages 

oO are displayed on the standard output device, and error and warning 
messages are included in the print file. In the sign-off message 
BND386 reports the number of errors. 
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ERRORPRINT/NOERRORPRINT (continued) 
NOTE 


If the specified file name matches the name of a file on the 
input list or the name of a control or output file, BND386 


processing aborts. 


Examples 


1. In the following examples, error or warning messages go to the 
error print file MOD2.LIS and to the print file that contains the 


DOS: 


VMS: 


DOS: 


VMS: 


DOS: 


VMS: 
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segment map. 
BND386 MOD1.OBJ ERRORPRINT (MOD2.LIS) 


BND386/ERRORPRINT = MOO2.LIS MOD1.OBJ 


2. In the following examples, no error print file is created; by 
default, error messages are included in the print file. 


BND386 MOD3.0BJ, MO04.0BJ 


BND386 MOD3.0BJ, MOD4.0BJ 


3. In the following examples, error and warning messages are sent to 


the standard output device. 
BND386 MOD5.OBJ, MOD6.0BJ ERRORPRINT 


BND386/ERRORPRINT MOD5.OBJ, MOD6.OBJ 
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oO Syntax 


DOS: FIXEDPAGES [(seg-name[,.. 


FIXEDPAGES 


Fixes segments in memory 
for real-time applications 


2) 


VMS: /FIXEDPAGES [= (seg-name[,...])] 


Abbreviation 


FP 


Default 


FIXEDPAGES is not in effect. 


oO Description 


The FIXEDPAGES control allows you to indicate that selected, or all, 
segments are to be fixed in memory (that is, not pageable). This limit 
is required for real-time applications to prevent swapping out of 
memory. Refer to the documentation for your target operating system 
to see whether this feature is supported. 


NOTE 


FIXEDPAGES is effective only when used with LOAD. 


Examples 


In the following examples, SEG-NAME is specified as not paged and 


oO will appear in memory. 


DOS: 8ND386 MO0D1.0BJ LOAD FIXEDPAGES (SEG-NAME) 


VMS: BND386/LOAD/FIXEDPAGES = SEG-NAME MODE1.0BJ 
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INT286 


Provides interface control 
to 80286 programs 


Syntax 


DOS: 


INT286 [(mod-name [,...])] 


VMS: /INT286 [= (mod-name[,...])] 


Abbreviation 


I2 


Default 


INT286 is not in effect. 


Description 
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The INT286 control allows 80386 programs to interface with 80286 
programs and ensures that data in specified modules resides in the 
combined USEI6 segment in the first 64K bytes of memory. Read- 
write segments in the specified modules and in all stack segments 
become USE16 segments. 


In data/stack combined (DSC) segments, the stack is installed at the 
beginning and the segment is expanded up. This feature allows both 
80286 and 80386 programs to refer to the same USE16 stack, because 
the stack offset is always less than 64K bytes. 


Only stack segments become USE16 segments when no module is 
specified. 


The INT286 control is also useful in other applications. For example, 
you can create a DSC segment that can be expanded up: with the 
stack at the beginning of the segment, the data part can be expanded 
at run-time. 
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INT286 (continued) 


Examples 


DOS: 


VMS: 


DOS: 


VMS: 


1. Jn the following examples, the data segments of the specified 
module become USE16 segments. USE16 segments are placed 
below USE32 segments. 

BND386 MOD1.0BJ, MOD2.0BJ INT286 (MOD-NAME) 


BND386/INT286 = MOD-NAME MOO1.0BJ, MOD2.0BJ 


2. In the following examples, the stack is made up of USE16 
segments, which are placed below USE32 segments. 


BND386 MOD.OBJ INT286 


BND386/INT286 MOD.OBJ 
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LDTSIZE 
Extends the limit LDT in 
loadable output module 


Syntax oO 


DOS: LDTSIZE ([+]number) 


VMS: /UDTSIZE = "+number" 
LDTSIZE = number 


Abbreviation 


LS 


Default 


LDT size is based on the number of descriptors in the loadable output 


module. a) 


Description 
The LDTSIZE control extends the limit of the LDT in the loadable 
output module as follows: 


e When number is specified, the LDT contains the specified 
number of slots. 


e When + precedes number, the LDT is expanded by the specified 
number of slots. 


Unused LDT slots are filled with zeroes. 


See the documentation for your target operating system for more 
details. 


*) 
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LDTSIZE (continued) 
NOTES 


LDTSIZE is effective only when used with LOAD. 


The results of LDTSIZE can be affected by the RESERVE 
control. 


Examples 


1. In the following examples, ten additional slots are included at the 
end of the local descriptor table for the loadable module. 


DOS: BND386 MOD1.0BJ, MOD2.0BU LDTSIZE (+10) 


VMS:  BND386/LDTSIZE = "+10"HO01.0BJ, MOD2.OBU 


2. In the following examples, the local descriptor table of the output 
module contains 300 slots. 


DOS:  BND386 MOD1.0BJ, MOD2.0BJ LDTSIZE (300) 


VMS:  BND386/LDTSIZE = 300 MOD1.0BJ, MOD2.0BJ 
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LOAD/NOLOAD 


Creates a loadable (LOAD) or 
linkable (NOLOAD) module 


Syntax 

DOS: LOAD 
NOLOAD 

VMS: /LOAD 
/NOLOAD 


Abbreviations 


LO 


NOLO 


Default 


LOAD 


Description 
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The LOAD control creates a loadable module containing an executable 
program and data plus system items such as an LDT. The single-task 
module can be loaded on an 80386 protected-mode system under the 
control of the operating system. (Use the RCONFIGURE control to 
create a loadable module targeted specifically for an 80386 operating 


system.) 


The NOLOAD control creates a linkable module that can be used in 
subsequent BND386 invocations or as input to the builder. By 
default, the linkable module is placed in the file called first-input- 


filename. LNK. 


Refer to the OBJECT entry later in this chapter for information on the 


assignment of the name of the object file. 
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LOAD/NOLOAD (continued) 
NOTES 
DEFAULTPAGES, FIXEDPAGES, LDTSIZE, RCONFIGURE, 


RELDESC, and RESERVE are not effective when used with 
NOLOAD. 


The NAME, PUBLICS, and NOPUBLICS controls work only when 
NOLOAD is in effect. 


Examples 
1. In the following examples, a loadable module is produced; LOAD 
is in effect by default. By default, MODI is the output file 
name for DOS and MOD1.DAT is the output file name for VMS. 
DOS: BND386 MOD1.0BJ, MO02.0BJ 


VMS:  BND386 MO0D1.0BJ, MOD2.0BJ 


2. In the following examples, a linkable object module is produced. 
MOD3.LNK is the output file name. 


DOS: BND386 M00D3.08J, MOD4.0BJ NOLOAD 


VMS: 8ND386/NOLOAD MOD3.0BJ, MO04.0BJ 


3. In the following examples, the NOLOAD control produces a 
linkable object module. Modules MODI! and MOD2 in 
MOD3.OBJ are input along with MOD4.OBJ. 

DOS: BND386 MOD3.0BJ (MOD1,M002), MOD4.0BJ NOLOAD 


VMS: BND386/NOLOAD "M0D3.0BJ(MOD1,MOD2)", MOD4.OBJ 
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MOD376/MOD386 
Verifies that input object module 
meets 80376 or 80386 requirements 


Syntax  ] 


DOS: M0OD376 
MOD386 


VMS: /MOD376 
/MOD386 


Abbreviations 
M376 


M386 


Default . we) 


MOD386 


Description 


The MOD376 control checks the input object module and issues 
warnings if the module is not suitable for the 80376. 


When binding the 80376, make sure the input object module contains 
only USE32 code segments. USE16 code segments are not executable 
on the 80376 


Because the 80376 has a 24-bit address bus, addresses greater than 16 
megabytes wrap around to low memory and can overlay segments that 

are in low memory. Therefore, BND386 issues a warning when you 

specify MOD376 and the object file contains addresses greater than 16 oO 
megabytes. 
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MOD376/MOD386 (continued) 


Examples 


VMS: 


DOS: 


VMS: 


1. In the following examples, a loadable module is produced for 
execution on the 80386; MOD386 is in effect by default. MOD3 is 
the loadable object from the two linkable files, MOD1.OBJ and 
MOD2.OB]. 


BND386 MOD1.0BJ, MOD2 OBJECT(MOD3) 


BND386/OBJECT = MOD3 MOD1.0BJ, MOD2.0BJ 

2. In the following examples, a loadable object file is produced for 
execution on the 80376. MOD376 directs BND386 to perform 
error checking. 

BND386 MOD1.0BJ, MOD2.0BJ OBJECT(MOD3) M376 


BND386/OBJECT = MOD3/M376 MOD1.0BJ, MOD2.0BJ 
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NAME 


Names the linkable 
output module 


Syntax 
DOS: NAME (mod-name) 


VMS: /NAME = mod-name 


Abbreviation 


NA 


Default 


NAME (first-input-mod-name) 


Description 


The NAME control assigns a name to the linkable output module. 
When NOLOAD is in effect and the NAME control is not specified, 
BND386 assigns the name of the first input module (first-input- 
mod-name) encountered in the input list to the linkable output 
module. NAME does not affect the file name of the file containing 
the linkable module. 


NOTE 


NAME is effective only when used with NOLOAD. 
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NAME (continued) 
Examples 


In the following examples, MOD-NAME is the output linkable 
module. 


© DOS: BND386 MOD1.0BJ, MOD2.0BJ NOLOAD NAME (MOD-NAME) 


VMS: BND386/NOLOAD/NAME = MOD-NAME MOD1.0BJ, MOD2.0BJ 
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OBJECT/NOOBJECT 


Creates and names or suppresses creation 
of the output object module 


Syntax oO 


DOS: OBJECT [ (filename) ] 
NOOBJECT 


VMS: /OBJECT [= filename] 
/NOOBJECT 


Abbreviations 
OJ 


NOOJ 


Default oO 


For DOS operating systems, loadable output is OBJECT (first- 
input-filename) and linkable output is OBJECT (first-input- 
filename.LNK) 


For VMS operating systems, loadable output is OBJECT (first- 


input-filename.DAT) and linkable output is OBJECT (first- 
input-filename.LNK). 


Description 
The OBJECT control creates an object file, either assigning the 
specified file name or using the default file name when filename is 
not specified. 


The NOOBJECT control prevents the creation of an object file. oO 
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oO 


OBJECT/NOOBJECT (continued) 
NOTE 


If the name of the specified file or the name of the default 
file matches the name of an input file, print file, or control 
file, BND386 processing aborts. 


Examples 


DOS: 


VMS: 


DOS: 


VMS: 


DOS: 


VMS: 


DOS: 


VMS: 


1. In the following examples, BND386 places the DOS loadable 
output module in a file with the default file name MODI; 
BND386 places the VMS loadable output module in a file with 
the default file name MODI.DAT. 


BND386 MOD1.0BJ, MOD2.OBJ OBJECT 


BND386/OBJECT MOD1.0BJ, MOD2.OBJ 


2. In the following examples, BND386 outputs an object file with 
same name as the first file in the control file CNTRL3.DAT, 
with extension, or file type, .LNK. 

BND386 CF (CNTRL3.DAT) NOLOAD OBJECT 


BND386/CF = CNTRL3.DAT/NOLOAD/OBJECT 


3. In the following examples, BND386 outputs a loadable output 
module called MOD6.DAT. 


BND386 MOD4.0BJ, MOD5.OBJ OBJECT (MOD6.DAT) 


BND386/OBJECT = MOD6.DAT MOD4.0BJ, MOD5.OBJ 


4. In the following examples, BND386 outputs only a print file. 
BND386 MOD7.0BJ, MOD8.0BJ NOLOAD NOOBJECT 


BND386/NOLOAD/NOOBJECT MOD7.0BJ, MOD8.OBJ 
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PRINT/NOPRINT 
Creates and names or suppresses 
creation of a print file 


Syntax 


DOS: PRINT [(filename) ] 
NOPRINT 


VMS: /PRINT [= filename] 
/NOPRINT 


Abbreviations 
PR 


NOPR 


Default 


PRINT 


Description 


The PRINT control creates and names a print file, which contains a 
segment map, a module list, a list of unresolved symbols, and warning 
and error messages. When the file name is specified, it is assigned to 
the print file. Otherwise, the file name of the print file is assigned 


by default, as follows: 


e When PRINT is not specified or is specified without a file name, 
the name of the print file is the same as that of the file 
containing the output object module, with extension, or file type, 


-MPI. 


e When NOOBJECT is in effect, the print file is assigned the name 
of the first input file, with extension, or file type, .MPI. 


The NOPRINT control prevents the creation of a print file. 
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*) 


PRINT/NOPRINT (continued) 


The contents and format of the print file are described later in this 
chapter in Section 2.14. 


The ERRORPRINT control can be used to create a separate print file 
for error messages only. 


NOTES 
When the name of the specified file or the name of the default 
file matches the name of an output file or a file on the input 
list, BND386 processing aborts. 


A message about a fatal error condition is always displayed on 
the standard output device. 


The default file name of the print file is affected by any file 
name specified with OBJECT. 


Examples 


1. In the following examples, BND386 produces a print file called 
MOD3.MP1. 


DOS: — BND386 MOD1.0BJ, MOD2.0BJ OBJECT (MOD3.DAT) 


VMS: BND386/OBJECT = MOD3.DAT MOD1.0BJ, MOD2.OBU 


2. In the following examples, no print file is produced. 
DOS: BND386 MOD4.0BJ, MOD5.OBJ NOPRINT 


VMS: BND386/NOPRINT MOD4.0BJ, MOD5.0BJ 
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PRINT/NOPRINT (continued) 
3. In the following examples, BND386 produces a print file called 


DOS: 


VMS: 


DOS: 


VMS: 
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MOD8.LIS. 
BND386 MOD6.0BJ, MOD7.OBJ PRINT (MOO8.LIS) 


BND386/PRINT = MOD8.LIS MOD6.0BJ, MOD7.OBJ 


4. In the following examples, BND386 produces a print file called 


MOD9.MP1. 
BND386 MOD9.0BJ NOOBJECT 


BND386/NOOBJECT MOOD9.OBJ 
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PUBLICS/NOPUBLICS 


Retains or removes selected public symbol 
definitions in linkable output modules 


© Syntax 


DOS: 


VMS: 


PUBLICS [EXCEPT (symbol[,...])] 
NOPUBLICS [EXCEPT (symbol[,...])] 


/PUBLICS [/EXCEPT = (symbol[,...])] 
/NOPUBLICS [/EXCEPT = (symbol[,...])] 


Abbreviations 


For DOS, PL [EC], NOPL [EC]. 


For VMS, PL [/EC], NOPL [/EC]. 


oO Default 


PUBLICS 


Description 


The PUBLICS control keeps some or all of the public symbol 
definitions in the linkable output module. You can use the EXCEPT 
specification to exclude a unique symbol or, with the asterisk (*), to 
exclude a group of public symbol definitions with a common prefix. 
For example, to purge all occurrences of publics with the prefix DQ, 
you would simply enter: 


ba* 


The NOPUBLICS control removes some or all public symbol definitions 
from the linkable module. Again, you can use the EXCEPT 
specification to select public symbol definitions to be included in the 
linkable module. 
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PUBLICS/NOPUBLICS (continued) 


The NOPUBLICS EXCEPT construction is useful during modular 

program development. For example, you can link some modules into 

a subsystem and grant access to the subsystem only through specific 

entry points. This construction reduces the chance of error and also 

allows different subsystems to use the same public name for different Oo 
purposes (just as you might allow local variables in different 

procedures to have the same name). 


The PUBLICS EXCEPT construction is useful when you want to hide a 
few names from the rest of the application, but still keep most public 
names visible. 


Public symbols that represent gates created by the builder cannot be 
specified with EXCEPT. 


NOTE 


PUBLICS and NOPUBLICS are effective only when used with 
NOLOAD. When a loadable module is created, public symbol 
definitions are removed from the output object module and 
retained only as debug information for debuggers. ie) 


Examples 
1. In the following examples, the linkable module in MOD4.LNK 
contains no public symbol definitions except SYMBOL2 and 
SYMBOL3. MOD1.OBJ is the input file. 
DOS: BND386 MOD1.0BU NOLOAD NOPL EC (SYMBOL2, SYMBOL3) OJ (MOD4.LNK) 


VMS: BND386/NOLOAD/NOPL/EC = (SYMBOL2, SYMBOL3)/OJ = MOD4.LNK MOD1.OBJ 
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DOS: 


VMS: 


DOS: 


VMS: 


PUBLICS/NOPUBLICS (continued) 


2. In the following examples, public symbol definitions are included 
in linkable modules MOD5.OBJ and MOD6.OBJ by default. 


BND386 MOD5.OBJ, MO06.0BJ NOLOAD 


BND386/NOLOAD MOD5.0BJ, MOD6.0BJ 


3. In the following examples, all publics except those starting with 
the prefix PLM are purged. 


BND386 MOD1.OBJ NOLOAD NOPUBLICS EXCEPT (PLM*) 


BND386/NOLOAD/NOPUBLICS/EXCEPT = (PLM*) MOD1.0BJ 
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PURE/NOPURE 
Enables sharing of text between programs 
under UNIX operating systems 


Syntax oO 


DOS: PURE 
NOPURE 

VMS: /PURE 
/NOPURE 


Abbreviations 
PU 


NOPU 


Default oO 


NOPURE 


Description 
The control makes it possible to share text between programs under 
the UNIX operating system. The operating system places program 
code in a page table that is separate from program data, enabling it to 
share text but not data. 


The NOPURE control prevents sharing text between programs. 


Examples 


In the following examples, the PURE control allows the text of oO 
MOD.OBJ to be shared. 


DOS: 8ND386 MOD.OBJ PURE 


VMS:  BND386/PURE MOD.OBJ 
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Syntax 


RCONFIGURE 


Produces bootloadable output 
for an 80386 operating system 


DOS: RCONFIGURE [(DYNAMICMEM (memory-range) ) ] 


VMS: /RCONFIGURE [= "DYNAMICMEM (memory-range)"] 


Abbreviation 


RC[ (DM) ] 


Default 


RCONFIGURE is not in effect. 


Description 


The RCONFIGURE control produces an output file that can be loaded 
on an 80386 operating system. 


The DYNAMICMEM specification selects the memory range, which 
specifies the minimum and maximum dynamic memory requirements 
of the output task. Specify memory-range as follows: 


min[ ,max] 
Where: 


min 
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is an integer representing the minimum 
dynamic memory requirement of the output 
task. When you specify min only, BND386 sets 
minimum and maximum requirements to this 
value. 
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RCONFIGURE (continued) 


max is an integer representing the maximum 
dynamic memory requirement of the output 
task. The max specification must be greater 
than or equal to the minimum value or BND386 


will issue an error message. oO 


A minimum size of LDTSIZE is assumed. 


NOTES 
LOAD and RELDESC are automatically in effect with 
RCONFIGURE, and LOAD, NOLOAD, or RELDESC controls in the 
invocation are ignored. 


When RCONFIGURE is in effect, the privilege level cannot be 0. 


Examples 
1. In the following examples, BND386 produces an output module 
that can be loaded on an 80386 operating system. BND386 
instructs the operating system to allocate OOAFH bytes of we) 


dynamic memory for the output task. 
DOS: BND386 MOD1.0BJ RCONFIGURE (DYNAMICMEM(OOAFH)) 


VMS: BND386/RCONFIGURE = "DYNAMICMEM(OOAFH)" MOD1.0BJ 


2. In the following examples, BND386 produces an output module 
that can be loaded on an 80386 operating system. BND386 
instructs the operating system to allocate at least OOAFH bytes 
and at most OAF45H bytes for the output task. 

DOS: BND386 MO001.0BJ, MOD2.0BJ RC (DM(OOAFH, OAF45H)) 


VMS:  BND386/RC = "DMCOOAFH,OAF45H)" MOD1.0BJ, MOD2.0BJ 
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Oo 


oO 


RELDESC 


Generates temporary 
descriptor table 


Syntax 
DOS: RELDESC 


VMS: /RELDESG 


Abbreviation 


RD 


Default 


RELDESC is not in effect. 


Description 


The RELDESC control chooses between a final LDT and a relocatable 
descriptor table (RELDESC). When RELDESC is in effect, a temporary 
descriptor table is generated and the final LDT is generated by the 
loader. Use this feature when the operating system requires an 
existing descriptor table in which to place the descriptors of the 
loadable module. 


See the documentation for your target operating system for more 
details. 


NOTES 
RELDESC is effective only when used with LOAD. 


When RCONFIGURE RELDESC is automatically used without 
being specified. 
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RELDESC (continued) 
Examples 
1. In the following examples, a loadable module is created and a 


DOS: 


VMS: 


DOS: 


VMS: 
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temporary descriptor table is generated. 
BND386 MOD1.0BJ LOAD RELDESC 


BND386/LOAD/RELDESC MOO1.OBJ 


2. In the following examples, a loadable module is created and a 


final LDT is generated. 
BND386 MOD1.0BJ LOAD 


BND386/LOAD MOD1.OBJ 
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Oo 


RENAMESEG 


Renames an input 


segment 
oO Syntax 
DOS: RENAMESEG (old-seg-name TO new-seg-name [,...]) 
VMS: /RENAMESEG = ("old-seg-name TO new-seg-name"[,...]) 


Abbreviation 


RN 


Default 


RENAMESEG is not in effect. 


Description 


The RENAMESEG control changes the names of input segments. All 


_ input segments named old-seg-name are renamed new-seg-name to 


provide control over segment combination. All input segments are 
first renamed and then combined as necessary. The specified segment 
name cannot be longer than 40 characters. 


Any reference to a renamed segment in other controls in the 
command line, should refer to the new segment name. 


Examples 


DOS: 


VMS: 


In the following examples, the segment MODCODE! in MOD1.OBJ is 
renamed MODCODE2. The new name is then used in the SEGSIZE 
control. 

BND386 MOD1.0BJ RN (MODCODE1 TO MODCODE2) SS (MODCODE2 (+20)) 


BND386/RN = "MODCODE1 TO MODCODE2"/SS = "MODCODE2(+20)" MOD1.0BJ 
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RESERVE 
Does not assign specified numbers 
as local descriptor table selectors 


Syntax *) 


DOS: RESERVE (numberl TO number2[,...]) 


VMS: /RESERVE = ("numberl TO number2"[,...]) 


Abbreviation 


RS 


Default 


RESERVE is not in effect. 


Description oO 


The RESERVE control does not allow numbers within the specified 
number-range to be assigned as local descriptor table selectors. 
BND386 assigns selectors to refer to the descriptors it creates for each 
segment and gate in loadable modules. The system loader later installs 
the descriptors in a local descriptor table. 


A maximum of 128 number-ranges can be specified. 


NOTES 
RESERVE is effective only when used with LOAD. 


RESERVE can affect the LDTSIZE control specification. 


*) 
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RESERVE (continued) 
Examples 


In the following examples, BND386 does not assign any LDT selectors 
in the range from 2 to 16 for the loadable module created. 


o DOS: BND386 MOD1.0BJ, MOD2.OBJ RESERVE (2 TO 16) 


VMS: BND386/RESERVE = ("'2 to 16") MOD1.0BJ, MOD2.OBJ 
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SEGSIZE 
Changes length of stack or data 
segment in output object module 


Syntax 
DOS: SEGSIZE (seg-name ([+/-]size)[,...]) 


VMS: /SEGSIZE = ("seg-name([+/-]size"[,...]) 


Abbreviation 


ss 


Default 


Segment size reflects combination, if any. 


Description 


The SEGSIZE control changes the length of one or more writable stack 
or data segments in the BND386 output object module. The length of 
a segment is the memory space it requires. Segment length can be 
increased, decreased, or set to a specific decimal value for a specified 
segment-name, as follows: 


e To increase segment length, set the size to a positive number, +n, 
where n is the number of bytes by which the segment length is to 
be increased. 


e To decrease segment length, set the size to a negative number, 
-n, where n is the number of bytes by which the segment length 
is to be decreased. 


e To specify a particular segment length, set the size to a 
hexadecimal number in bytes. For USEI6 segments, the size must be 
between 0 and OFFFFH (64K bytes). For USE32 segments, the size 
must be between 0 and OFFFFFFFFH (4 gigabytes) 
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SEGSIZE (continued) 


For segments with a combine type of DSC, the SEGSIZE control 
affects only the length of the stack portion. When the size of the 
stack in a DSC segment is set to zero, the DSC segment is converted 
to a data segment without a stack. 


BND386 pads all segments except those that are execute-only. The 
SEGSIZE control supersedes this padding. Note that the addition of 
bytes due to alignment cannot be suppressed, and the length of a 
segment is not the exact sum of all combined segments. 


Zero-length segments are purged from loadable modules but not from 
linkable modules. Therefore, zero-length segments are not listed in 
the segment map in the print file when the LOAD control is in effect. 


BND386 issues a warning if the specified segment does not have the 
write attribute; it also issues a warning whenever the size of a 
segment is decreased. BND386 ensures that references in the output 
module to any segment affected by SEGSIZE are within the specified 
limits. 


Oo Examples 


In the following examples, the length of each loadable module 
segment is changed as follows: 


e SEGI1 is increased by 47 bytes. 
e SEG2 is decreased by 47 bytes. 
e SEG3 is set to 511 bytes. 


The length of every other segment depends on segment combination. 


BND386 MOD3.0BJ, MOD4.OBJ SS (SEG1(+002FH), SEG2(-O02FH), & 
SEG3(O1FFH)) 


BND386/SS = ("SEG(+002FH)", "SEG2(-O02FH)", "SEG3(O1FFH)")- 
MOD3.OBJ, MOD4.OBJ 
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TASKPRIVILEGE 


Sets privilege level 
of task being created 


Syntax 
DOS: TASKPRIVILEGE(number) 
VMS: /TASKPRIVILEGE = number 


Abbreviation 


TP 


Default 


Privilege level 3. 


Description 


The TASKPRIVILEGE control sets the privilege level of the task being 
created and of all input segments to 0,1, 2, or 3. You can set the 
initial stack specifications in the TSS to the effective privilege level 
by specifying TASKPRIVILEGE when you are creating a loadable 


object module. 


Since the change is made before segments are combined, the input 


privilege level of segments has no meaning. 


NOTES 


TASKPRIVILEGE influences BND386 when both LOAD and 


NOLOAD are in effect. 


When RCONFIGURE is in effect, the TASKPRIVILEGE control 
cannot be set to 3. If the specified descriptor privilege level 
(DPL) is greater than 3, a warning is issued and the control is 


ignored, 
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*) 


TASKPRIVILEGE (continued) 
Examples 


In the following examples, BND386 sets the initial task privilege level 
to 2 and sets the privilege level of all segments to 2. 


Oo DOS: BND386 MOD1.0BJ TASKPRIVILEGE(2) 


VMS:  BND386/TASKPRIVILEGE = 2 MOD1.0BJ 
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TYPE/NOTYPE 


Enables or suppresses 


type checking 
Syntax © 
DOS: TYPE 
NOTYPE 
VMS: /TYPE 
/NOTYPE 
Abbreviations 
TY 
NOTY 
Default oO 
TYPE 
Description 


The TYPE control performs type checking between public and external 
symbols of the same name. A warning is issued when a mismatch is 
found. When used with NOLOAD, TYPE includes type definitions for 
all external and public symbols in the linkable output module. 


NOTYPE suppresses type checking and causes BND386 to omit type 
definitions from the linkable output module. When NOTYPE is in 
effect, there is no type checking for unresolved symbols in a loadable 
file. 


oO 
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TYPE/NOTYPE (continued) 
Examples 


1. In the following examples, type checking is done on all external 
and public symbols. 


DOS: BND386 MOD1.0BJ, MOD2.0BJ TYPE 


VMS:  8ND386/TYPE MOD1.0BJ, MOD2.0BJ 


2. In the following examples, no type checking is done. 
DOS: 8BND386 MOD3.0BJ, MOD4.0BJ NOTYPE 


VMS: BND386/NOTYPE MOD3.0BJ, MOD4.0BJ 
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2.14 Print File 


2-74 


The print file contains the following sections (see Figure 2-4). 


Header 
Segment map 


Input module list 


Unresolved external symbol list (if BND386 has not been able to 
resolve one or more external symbol references) 


Error and warning messages if present 


Summary of memory usage 
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60386 BINDER dd/mm/yy hh/mm/ss 
system-id 803486 BINDER, Vx-yVX 

INPUT FILES: MAIN-OBJa UTIL. OBJ 

OUTPUT FILES: MAIN-LNK 

CONTROLS SPECFIED: NOLOAD. NAME=EXAMPLE_MAIN 

*** WARNING 151: UNRESOLVED EXTERNAL SYMBOLS 


SEGMENT MAP 


LIMIT ACCESS ALIGN USE COMBINE TYPE 
goo00eEbH ER BYTE USELL NORMAL 
o00041CBH Ru WORD USELb DSC 


INPUT MODULES INCLUDED: 


MAIN (MAIN. OBJ) 
UTIL (UTIL-OBu) 


UNRESOLVED EXTERNAL SYMBOLS: 


SYMBOL NAME REFERRING MODULE 
DAATTACH MAIN 

DACLOSE MAIN 

DACREATE MAIN 

DQ@DETACH MAIN 

DQEXIT MAIN 

DQOPEN MAIN 

DQREAD MAIN 

DQURITE MAIN 

PROCESSING COMPLETED. 1 WARNING, 


PAGE 1 


COMBINE NAME 


CODE 
DATA 


OD ERRORS 


m-0555 


Figure 2-4 Sample BND386 Print File 


The following explanations of the print file sections are accompanied 


by generic examples of the print file format. 


VMS examples show controls in control-file format rather than 
command-line format, which includes the backslash separator for 


controls. 
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2.14.1 Header 


The print file header summarizes the invocation specifications (see 


Figure 2-5). 
603486 BINDER mm/dd/yy hhimm:ss PAGE number 
system-id 80386 BINDER, Vx-yVX 
INPUT FILES: filenamel, filenamee ... 


OUTPUT FILES: filename-n 
CONTROL SPECIFIED: controll. controle --.- 


gamomosater = (warnings, if any. will appear here) 


Figure 2-5 BND386 Print File Header 


2.14.2 Segment Map oO 


The segment map provides the following information for each 
segment in the output object module (see Figure 2-6): 


e LIMIT: the segment limit, in bytes, with a suffix of H (for 
hexadecimal). The limit is the offset of the last byte in a 
segment. Unless the SEGSIZE control is used to specify an exact 
segment length, the limit may be a few bytes longer than the 
actual limit (to accommodate references to the last byte of the 
segment). 


If a segment has the length of zero, then EMPTY is printed in 
the LIMIT column. Zero-length segments are purged from 
loadable modules. Therefore, they are not listed in the segment 
map when LOAD is in effect. Segments that have expand down 
attribute will have a LIMIT of (0 - segment size - 1). 


e DPL: the descriptor privilege level. oO 
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e ACCESS: one or more of the following segment attributes: 


— C (conforming): a segment that can be shared by programs 
that execute at lower (numerically higher) privilege levels 
without using gates. 


— D (expand down): a nonexecutable segment whose limit can 
be extended toward lower-order addresses at run time. 


— EO (executable only): a code segment that can only be 
executed, not read. 


— ER (executable and readable): a code segment that can be 
executed and read. 


— RO (readable only): a data segment that can only be read. 


— RW (readable and writable): a data segment that can be read 
from and written to. 


e ALIGN: two segments are combined according to the stricter of 
the two alignment types; e.g., if a byte and a word are combined, 
the new segment is type word. (The following types are valid: 
byte, word, dword, quad, para, inpage, and page.) 


e — USE: can be USE16 or USE32. USE16 segments have a limit of 
64K bytes and USE32 segments have a limit of 4 gigabytes. For 
code segments, this attribute determines the default addressing 
width and the default operation width. 


e COMBINE TYPE: one of the following, describing information in 
the segment: 


— BLANKCOMMON: segments that contain FORTRAN-286 
common blocks that are not named. 


— COMMON: segments that contain FORTRAN-286 common 
blocks that are named. 


— DSC: data/stack combined segments, which contain normal 
data segments and stack segments. 


— NOCOMBINE: code or data segments that are not 
combinable: for example, ASM386 segments that are not 
declared PUBLIC and PL/M-286 segments compiled under 
the LARGE model. 
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— NORMAL: code or data segments that are combinable; for 
example, ASM386 segments that are public or PL/M-386 


segments. 


— STACK: stack segments. 


e COMBINE NAME: the name of the segment. In assembler 
programs, this name is given by the user. In high level language 
programs such as PL/M, the name is given by the compiler, and 
depends on the model of segmentation used. 


SEGMENT MAP 


LIMIT ACCESS ALIGN USE COMBINE TYPE COMBINE NAME 
XXXXXXXXH XXXX XXXX XXXXX XXXXXXXXKXXXK XXXXXXXXXXKXKXXXXK 
XXXXXXXXH XXXX XXXX XXXXX XXXXXKXXXXXK XXXXXKXXXKXKXXKXXXX 
XXXXXXXXH XXXX XXXX XXXXX XXXXXXXXXXX KXXXXXXXXXXKXXKXXXXK 
m-0557 
Figure 2-6 BND386 Print File Segment Map 
2.14.3 Input Modules List 


The print file contains a list of all input modules processed by 
BND386 and the file name in which the modules appeared in the 
input list (see Figure 2-7). The order is the same in which the input 


modules were encountered in the input list. 


INPUT MODULES INCLUDED 


"module-namel” ("filename1™) 


"module-name-n" ("filename-n™) 


Figure 2-7 BND386 Print File Input Module Map 
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* 


2.14.4 Unresolved Symbols List 
Figure 2-8 shows the format of the section that provides information 
for each unresolved reference in the segments processed: 
oO e SYMBOL NAME: the name of the referenced symbol. 


e REFERRING MODULE: the name of the first input module that 
contains a reference to the symbol. 


UNRESOLVED EXTERNAL SYMBOLS: 


SYMBOL NAME REFERRING MODULE 
XXXXXXXXXXXXXX XXXXXXXXXXXXX 
XXXXKKXXXXXXXKXXX XXXXXXXXXXXXX 
<aeseeesasSs Cerrors/warnings, if any. will appear here) 
© Figure 2-8 BND386 Print File Unresolved Symbol List 


2.14.5 Warning and Error Messages 


Appendix A defines the error and warning messages that can appear 
in the print file. 


2.15 Using BND386: Examples 


The example below illustrates the two stages in developing an 
application program. First, modules that contain application code are 
linked together. The resulting linkable module is then linked with a 

Oo system file to create a loadable module. The loadable module is a 
program that can be executed on 80386-based systems. 
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DOS: 


VMS: 


DOS: 


VMS: 


2-80 


Figure 2-9 shows the BND386 print file produced when two linkable 
C-386 modules (named MAIN.OBJ and UTIL.OBJ) are processed with 
BND386,. The DEBUG compiler control provides symbolic information 
useful later during debugging. The following St a is used to 
invoke the compiler: 


C386 MAIN.C DEBUG 
C386 UTIL.C DEBUG 


C386/DEBUG MAIN.C 
C386/DEBUG UTIL.C 


After compilation, the BND386 NOLOAD control is used to create a 
combined linkable module from MAIN.OBJ and UTIL.OBJ. The 
linkable module that is produced is placed in the file MAIN.LNK (by 
default) and named EXAMPLE-MAIN. 


BND386 MAIN.OBJ, UTIL.OBJ NOLOAD NAME (EXAMPLE-MAIN) 
BND386/NOLOAD/NAME = EXAMPLE-MAIN MAIN.OBJ, UTIL.OBJ 


The linkable output module contains two segments--an executable- 
readable segment (code) and a readable-writable data/stack combined 
segment (data) (see Figure 2-9). 


The value in the LIMIT column can be different from the sum of the 
lengths of the input segments. BND386 will change the combined 
segment lengths as follows: 


e When determining the output segment limits during combination, 
BND386 aligns the second segment according to its alignment 
attribute. 


e The segment limit (the offset of the last byte in a segment) is 
equal to the (combined) segment size minus one. 


e The segment can be padded by one to six bytes. In this example, 
code is padded by one byte and data by two bytes 
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Oo 


60346 BINDER dd/mm/yy hh/mm/ss PAGE 


system-id 6034b BINDER Vx-yVX 
INPUT FILES: MAIN. OBds UTIL-OBJ--- 
OUTPUT FILES: MAIN-LNK 


CONTROLS SPECIFIED: NOLOAD. NAME=EXAMPLE=MAIN 
*** WARNING 151: UNRESOLVED EXTERNAL SYMBOLS 
SEGMENT MAP 


LIMIT ACCESS ALIGN USE COMBINE TYPE COMBINE NANE 
ogoo00cEbLH ER BYTE USE32 NORMAL CODE 
oO00041CBH Ru WORD USE32 DSC DATA 


INPUT MODULES INCLUDED: 


MAIN (MAIN. OBJ) 
UTIL (UTIL. OBU) 


UNRESOLVED EXTERNAL SYMBOLS: 


SYMBOL NAME REFERRING MODULE 

DQATTACH MAIN 

DACLOSE MAIN 

D@CREATE MAIN 

D@DETACH MAIN 

DQEXIT MAIN 

DQOPEN MAIN 

DQREAD MAIN 

DQURITE MAIN 

PROCESSING COMPLETED. 1 WARNING O ERRORS 


m-0560 


Figure 2-9 BND386 Print File for Linkable Output Containing Unresolved 


Symbols 


Because the modules MAIN.OBJ and UTIL.OBJ were linked with no 
errors, the output module is valid and ready to convert to a loadable 
module. Linking the module EXAMPLE-MAIN with UDI.LB2 
resolves the external references because UDI.LB2 contains information 
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the operating system needs to make the system calls possible. The 
following invocation creates a loadable program and the print file 
shown in Figure 2-10: 


DOS: BND386 MAIN.LNK, UDI.LB2 CF (EXMPL1.CFL) OBJECT (EXMPL1.386) oO 
VMS: BND386/CF = EXMPL1.CFL/OBJECT = EXMPL1.386 MAIN.LNK, UDI.LB2 


BND386 creates a loadable module, because LOAD is in effect by 
default. 


As "controls specified" in Figure 2-10 indicates, the control file 
contains the following controls: 


DEBUG 
SEGSIZE (code/data (+100)) 


Using the control file in this case is equivalent to including DEBUG 
and SEGSIZE in the invocation line. 


EXMPL1.386, as specified by the OBJECT control. This module 
contains segments from the module created in the first BND386 
invocation, EXAMPLE-MAIN, and from the module in the system 
library UDI.LB2. 


The resulting output object module is placed in a file named Oo 


The segment named code/data contains a stack portion whose limit 
is 100 bytes larger than that of DATA in the input module 
EXAMPLE-MAIN. This difference is due to the SEGSIZE control 
used, which specifies that the limit of the segment named data is to 
be increased 100 bytes. 


Because the system library UDI.LB2 contains public definitions for all 
symbols declared external in EXAMPLE-MAIN, no references remain 
unresolved. Any unresolved references are listed in the print file. 


The output module in file EXMPL1.386 is ready to load or debug . 

The DEBUG control in effect during both compilation and binding 

produces symbolic information that can be used by MAP386 and by a *) 
debugger. 
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60386 BINDER mm/dd/yy hhimm:ss PAGE 1 
system-id 4038L BINDER, Vx-yVX 


INPUT FILES: MAIN-LNK3 UDI-LBe 
OUTPUT FILE: EXMPL1L-366 
CONTROLS SPECIFIED: OUCEXMPL1-38b). DB. SSCDATAC+100)) 


SEGMENT MAP 


LIMIT ACCESS ALIGN USE COMBINE TYPE COMBINE NAME 
oogooeEbH ER BYTE USE3e NORMAL CODE 
oooo41LCBH RU WORD USE3e2 DSC DATA 


INPUT MODULES INCLUDED: 


main (MAIN-LNK) 
COPYRIGHT_YEAR(S)_INTEL_CORPORATION (udi-lb2) 


PROCESSING COMPLETED. O WARNINGS. O ERRORS 


Figure 2-10 BND386 Print File for Loadable Modules 
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Chapter 3 
Using the 80386 Librarian 


The LIB386 librarian organizes linkable object modules, which have 
been produced by 80386 compilers, assemblers, or other 80386 
utilities, into libraries. You can then create, examine, change, search, 
copy, and otherwise manipulate library files with LIB386 commands. 


You can construct object libraries around modules with common 
characteristics (i.e., modules that perform similar functions or are 
required for a particular system). For example, one library might 
contain modules that perform mathematical functions; another, 
modules that perform I/O routines. 


When invoking other 80386 utilities such as BND386, MAP386, or the 
BLD386 System Builder, you can gain access to all the applicable 
modules in a library simply by specifying the library file name, rather 
than having to type the names of all the modules. 


LIB386 operates in two modes: foreground (NOBATCH) or 
background (BATCH). In foreground mode, LIB386 queries, provides 
intermediate displays, and expects input from the keyboard. In 
background mode, LIB386 processes commands that have been 
redirected from a command file (or some type of batch file), and does 
not query you or expect interaction. Refer to the individual LIB386 
commands for the effects of background execution. See Section 3.8 
for a background execution example. 


Major Functions of LIB386 


LIB386 performs the following major functions: 
e Creates new libraries 


e Updates existing libraries by adding, deleting, or replacing 
modules 


e Backs up the library currently being processed before it is 
modified 


e Examines information in the libraries (e.g., names of modules or 
names of public symbols) 
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e Accesses or changes library-related information (e.g., the name or 
the version number) 


e Compresses the data structure of the library being processed, 
thereby speeding up the retrieval operation of other 80386 
utilities (such as BND386) that access library files 


e Requests help and receives a brief description of the specified 
LIB386 command 


Refer to Appendix B for LIB386 error messages. 


Input and Output 


LIB386 accepts object files as input. Object files contain a single 
object module, a sequence of object modules, or libraries (see Figure 
3-1). 


LIB386 output consists of library files, backup library files, console 
messages, and a listing file, depending on the commands and controls 

that are specified. A listing file can list modules in a library, public 

symbols in a library, or public symbols in a particular module. © 


The Target Library 


The library file that LIB386 is processing at any given time is called 
the target library. The file you specify in the invocation line or with 
the GET command becomes the target library file. All LIB386 
commands act on the target file. (The LIST command is an exception 
to this processing rule; LIST can operate on library files other than 
the target library file.) 


A specified library file remains the target file until you exit LIB386 
or specify another library as the target library. 


Oo 
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INVOCATION 
LINE 


BACKUP 
LIBRARY 
FILE 


LINKABLE 
OBJECT 
MODULES 


TARGET 
LIBRARY 
FILE 


LIB386 
LIBRARIAN 


PRINT 
FILE OF 
LISTING 


LIBRARY 
FILE(S) 


CONSOLE 
MESSAGES 


Figure 3-1 LIB386 Input and Output 


3.4 Library Sessions 


Single library file processing is referred to as a single LIB386 session. 
Only one target library can be processed per session. However, 
multiple library files can be processed sequentially without exiting 
LIB386. To do this sequential processing, close the current target 
library and then initialize another target library file for the next 
session. For more details on single and multiple sessions, see Section 
3.8. 
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3.5 


3.5.1 


3-4 


Invoking LIB386 


DOS Invocation Syntax 


To invoke LIB386 on a DOS operating system, use the following 


syntax: 


LIB386 [filename] (ese )] [eae )] 


Where: 


filename 


BATGH (BA) 


NOBATCH (NOBA) 


BACKUP (BU) 


NOBACKUP (NOBU) 


NOBATCH NOBACKUP 


is the name of the target library file. Specify 
the file name according to the operating system 
requirements. 


A library session is begun in one of two ways: 
by specifying a file name, which will initialize 
the target library, or by using the GET 
command to initialize the target library file. 
See the GET entry in this chapter for details on 
initializing target library files. 


specifies background mode. LIB386 processes 
commands that have been redirected from a 
command file. LIB386 runs interactively and 
expects input from the keyboard. 


specifies foreground mode. NOBATCH is the 
default. 


specifies that LIB386 create a backup file of the 
target library at the start of a new session. The 
backup file contains the version of the target 
library created during the last session, with 
extension .LBK. BACKUP is the default. 

BACKUP can be executed at the command level 
or as an invocation control. 


specifies that LIB386 does not create a target 
library backup file when a new session starts. 
NOBACKUP can be executed at the command 
level or as an invocation control. 
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* 


Oo 


3.5.2 VMS Invocation Syntax 


To invoke LIB386 on a VMS operating system, use the following 


syntax: 


NOBATCH 


LIB386 [filename] lig )] oe )] 


Where: 


filename 


BATCH (BA) 


NOBATCH (NOBA) 


BACKUP (BU) 


NOBACKUP (NOBU) 
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/NOBACKUP 


is the name of the target library file. Specify 
the file name according to the operating system 
requirements. 


Begin a library session in one of two ways: by 
specifying a file name, which will initialize 
the target library, or by using the GET 
command to initialize the target library file. 
See the GET entry in this chapter for details on 
initializing target library files. 


specifies background mode. LIB386 processes 
commands that have been redirected from a 
command file. LIB386 runs interactively and 
expects input from the keyboard. 


specifies foreground mode. NOBATCH is the 
default. 


specifies that LIB386 create a backup file of the 
target library at the start of a new session. The 
backup file contains the version of the target 
library created during the last session, with 
extension .LBK. BACKUP is the default. 


specifies that LIB386 does not create a target 
library backup file when a new session starts. 


3.5.3 Invocation Controls 


BACKUP, NOBACKUP, BATCH, and NOBATCH are the only controls that 
can be specified in the LIB386 invocation line. BACKUP and NOBATCH 


are the defaults. oO 


BACKUP and NOBACKUP can be specified as invocation controls, and 
they can also be used as commands. 


BACKUP creates a backup copy of a target library file each time a 
LIB386 session begins. LIB386 gives each backup file the same name 
as the original target library, with extension .LBK. 


When used as commands, BACKUP and NOBACKUP override the BACKUP 
or NOBACKUP controls used in invoking LIB386. See the BACKUP entry 
in this chapter for more details on using BACKUP and NOBACKUP. 


3.5.4 LIB386 Defaults 
When no controls are specified in the invocation line, LIB386 does: the 
following: a) 
e Begins operating in foreground mode 


e Displays the sign-on message and the foreground prompt, an 
asterisk (*) 


e At the beginning of a session, displays a line identifying the 
target library 


e If BACKUP is specified or implied, creates a backup copy of the 
target library at the beginning of a session, with extension .LBK. 


e Awaits command input 


If no file name is specified in the invocation line, LIB386 waits until 
a target library is initialized with the GET command. 


*) 
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Console Messages 


In foreground mode, LIB386 displays sign-on and sign-off ‘messages, 
queries for user response, and presents display messages and error 
messages. 


In background mode, LIB386 does not display queries for user 
response, because the utility is not interactive. LIB386 displays all 
other messages, including sign-on and sign-off messages, display 
messages, and error messages. 


When you invoke LIB386 without specifying a file name, the librarian 
signs on as follows: 


system-id 80386 LIBRARIAN, Vx.y 
Copyright years Intel Corporation 
* 


Where: 

system-id is the identifier and version number of the 
operating system. 

Vx. is the LIB386 version number 

years is the copyright year or years. 

* is the LIB386 prompt. The prompt appears 


only in foreground mode. 
When you specify a file name, LIB386 displays the sign-on message 
and one of two messages, as follows: 


e If the file name is the name of a new library: 


TARGET LIBRARY: [new-library] date/time-last-modified 
** 


e If the file name is the name of a library that already exists: 


TARGET LIBRARY: target-lib-name version date/time- 
last-modified 
*% 
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Where: 


target-lib-name is the name of the target library in the 
invocation line. 


version-number is the version number of the target library. oO 
date/time- 
last-modified date and time the target library was last 

processed. 


During processing, LIB386 issues warnings, error messages, or fatal 
error messages if it encounters any problems. When LIB386 
encounters a fatal error condition, an error message and the following 
sign-off message are displayed at the console: 

PROCESSING ABORTED 
See Appendix B for additional information about error conditions. 


LIB386 signs off when you exit from the librarian or from the current 
LIB386 session, as follows: Oo 


library-filename date/time-last-modified 
n MODULES ADDED, m MODULES DELETED 


Where: 
nandm are the numbers of added and deleted modules. 


3.6.1 Queries 
The following is an example of a LIB386 query: 
ALL Changes Lost, OK? [Y/N] 
This query appears when you specify the QUIT ABORT or QUIT 
INITIALIZE command and the target library has been changed but oO 


not updated. See the QUIT entry in this chapter for details on 
responses to this query. 
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3.6.2 


3.6.3 


3.7.1 


Display Messages 


An example of a display message is the target library’s identification 
banner. A banner is displayed in the following form when the target 
library file for the session is initialized: 


TARGET LIBRARY: target-lib-name version-date/time- 
last-modified 


Another display example is the listing of the library module names. 
See the LIST entry in this chapter for more details. 


A third type of LIB386 display message is the help summary. The 
help summary appears on screen when you enter the HELP command 
and briefly describes each LIB386 command. See the HELP entry in 
this chapter for more details. 


Error Messages 


Error messages are displayed when LIB386 encounters error 
conditions. Appendix B contains a listing and explanation of the 
LIB386 error messages. 


LIB386 Commands 


Hierarchical Levels 


The LIB386 command set contains two elements: the invocation line 
and library commands. These elements are organized into a 
hierarchical structure. The three hierarchical levels are the operating 
system level, the initial command level, and the action command level 
(see Figure 3-2). 


The operating system level is the outermost level; you can invoke 
LIB386 and specify the BATCH, NOBATCH, BACKUP, and NOBACKUP 
controls. When you exit LIB386, control returns to the operating 
system. 
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When no file name is specified in the invocation line, control transfers 
to the initial level. A single asterisk (*) prompt indicates that control 
is at the initial level, The BACKUP, NOBACKUP, GET, HELP, LIST, and 
QUIT commands are available at this level. Use the GET command at 
the initial level to initialize the action command level. (See the GET 
entry in this chapter.) Use the QUIT command to return to the 
operating system level. 


If the file name is specified in the invocation line, control transfers 
directly to the action command level, indicated by the double asterisk 
(**) prompt. Most of the LIB386 commands are available at this 
level. Use these commands to alter the target library contents. Use 
the QUIT command to return to the initial level or to the operating 
system level. 


Transfer of Levels 


Control transfers inward from the operating system to the action 
command level when the target library file is specified on the 
invocation line. A double asterisk prompt (**) indicates the action 
command level. All action level commands are available for 
execution. Section 3.5 contains details on specifying the target library 
file. 


Control transfers inward from the operating system to the initial 
command level if the target library file is not specified with the 
invocation. A single asterisk prompt (*) indicates the initial command 
level. All initial level commands (e.g., GET, LIST) can be executed. 
GET transfers control from the initial command level to the action 
command level. 


The QUIT command sequence must be executed to transfer control 


outward from the action or initial command level. See the QUIT entry 
in this chapter for details. 
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*) 


OPERATING SYSTEM LEVEL 


DELETE 


HELP 
LIST publics 
TO filename 


CINITIALIZE] 
(EXIT 


REPLACE 


[NAME] 
[VERSION] 
{PAGELENGTH] 


UPDATE 


Oo Figure 3-2 Levels of LIB386 Command Set 
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Effect of Entering the Interrupt Character 


The interrupt character terminates LIB386 activities (except for 
BACKUP), in foreground mode. However, LIB386 completes the 
portion of the command that was executing before the interrupt 
character was entered. For DOS systems, the interrupt character is 
<CTRL><BREAK>. For VMS systems, the interrupt character is 
<CTRL><C>. 


If BACKUP is specified either as a command or as a control and the 


interrupt character is entered, LIB386 finishes backing up the library 
before interrupting itself. 


Summary of Commands 
Table 3-1 summarizes LIB386 commands for DOS operating systems. 
Table 3-2 summarizes LIB386 controls for VMS operating systems. 
The default column shows the condition in effect when the control is 
not specified. 
Table 3-3 lists abbreviations of LIB386 controls. Each LIB386 control 
is listed alphabetically and described in detail in the section following 
Table 3-3. 

Command Syntax 


To invoke a LIB386 command, use the following syntax: 


command [parameters] [;comments] 


Where: 

command is the command specified (e.g., ADD). 

parameters are one or more items required by the 
command. Separate parameters by commas or 
blank spaces unless otherwise noted under the 
individual command. 

comments is the text between the semicolon (;) and a new 


line. LIB386 ignores this text. 
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You can continue the invocation line on additional lines by typing an 
ampersand (&) before the line terminator. When LIB386 encounters a 
line terminator, the command executes. 


Table 3-1 summarizes LIB386 commands for DOS operating systems. 
Table 3-3 summarizes LIB386 commands for VMS operating systems. 
The default column shows the condition in effect when the command 
is not specified. 


Each LIB386 command is listed alphabetically and described in detail 
in the section following Table 3-3. 


Table 3-3 lists abbreviations of LIB386 commands. These 


abbreviations are repeated in the following sections describing each 
command in detail. 
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Table 3-1 LIB386 Commands for DOS Operating Systems 
Command Syntax Description Default 


ADD {filename[(mod- Adds object module(s) to 
name|,...))]}[-. target library (at action level) 


BACKUP Enables or suppresses BACKUP 
NOBACKUP backup file for target library 
file (at initial level) 


COMPRESS Physically removes deleted | No compression 
modules from target library 
(at action level) 


DELETE {mod-name|,...] | *} Logically removes modules | None 
from target library (at action 
level) 


FIND symbol[....] Searches target library for None 
the public symbol(s) (at 
action level) 

GET filename Initializes target library file for | None 
session (at initial level) 

HELP Summarizes each LIB386 
command, keyword, and 
control 


LIST {filename 1[(mod- Lists module names of Console is default 
name|,...])]}[,..-] [TO | library files (at initial and output device. No 
filename2] [PUBLICS]' action levels) publics 


filenamet is required at the initial level, but is optional at the action level. The target library is the default for 


filename. O 
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Table 3-1 LIB386 Commands for DOS Operating Systems (continued) 


Command Line Syntax Description Default 


i) QUIT [ABORT | EXIT | Terminates current session | EXIT control of the 
INITIALIZE] (at initial and action levels). | QUIT command 
ABORT, EXIT, and only in BATCH 
INITIALIZE are QUIT mode 
command controls 


REPLACE moda-name1 BY Replaces one module from 

filename [(mod-name2|....])] the target library with one or 
more modules from another 
object file (at action level) 


SET [N] [V] [PL] [...-] Changes name (N) or N = 1 blank space 
version number (V) of target | V = 4 blank spaces 
library or changes the page |} PL = 23 lines 
length (PL) of listings (at 


a) action level) 
UPDATE Updates current target 
library file (at action level) 


filename’ Is required at the initial level, but is optional at the action level. The target library is the default for 
filename1. 


Oo 
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Table 3-2 LIB386 Commands for VMS Operating Systems 


Command Syntax Description 


ADD {filename[mod- Adds object module(s) to 
name|,...])]}L.-.] target library (at action level) 

BACKUP Enables or suppresses BACKUP 
NOBACKUP backup file for target library 


file (at initial level) 


COMPRESS Physically removes deleted | No compression 
modules from target library 
(at action level) 


DELETE {mod-name|,...]|*} Logically removes modules 
from target library (at action 
level) 


FIND symbol[....] Searches target library for 
public symbol(s) (at action 
level) 


GET filename Initializes target library file for 
session (at initial level) 

HELP Summarizes each LIB386 
command, keyword, and 
control 


LIST {filename 1[(mod- Lists module names of Console is default 
namef|,...])]}[,...] [TO library files (at initial and output device. No 
filename2] [PUBLICS]! action levels) publics 


filename’ is required at the initial level, but is optional at the action level. The target library is the default for 


filename1, O 
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Table 3-2 LIB386 Commands for VMS Operating Systems (continued) 
Command Line Syntax Description Default 


QUIT [ABORT | EXIT | Terminates current session | EXIT control of 

INITIALIZE] (at initial and action levels). | QUIT command 
ABORT, EXIT, and only in BATCH 
INITIALIZE are QUIT mode 
command controls 


REPLACE mod-name1 BY Replaces module from target 

filename [(mod-name2|....])] library with one or more 
modules from another object 
file (at action level) 


SET [N] [VJ] [PL] [...-] Changes name (N) or N = 1 blank space 
version number (V) of target | V = 4 blank spaces 
library or changes page PL = 23 lines 
length (PL) of listings (at 
action level) 


UPDATE Updates current target None 
library file (at action level) 
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VMS NOTE 


On VMS systems, LIB386 commands can be abbreviated 
according to the VMS notation if their first four characters are 
unique. Otherwise, the control name must be used in full or 
abbreviated according to Table 3-3. 


For example, since the first two characters of the BACKUP 
command are unique, the command can be abbreviated either 
as /BA or /BU, the LIB386 abbreviation shown in Table 3-3. 
VMS systems do not consider the full command name and the 
LIB386 abbreviation in Table 3-3 to be the same command. 
Therefore, do not mix abbreviations and full command names 
on the same invocation line. 


Commands 


ADD © 
BACKUP 
COMPRESS 


NOBACKUP 
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Table 3-3 Abbreviations for LIB386 Commands 
Commands 


QUIT 
ABORT 
EXIT 
INITIALIZE 


REPLACE 

SET 

NAME 
VERSION 
PAGELENGTH 
UPDATE 
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* 


ADD 
Add object modules 
to target library 


Oo Syntax 


oO 


DOS or VMS: ADD {filename [(mod-name[,...])]} [,...] 
Where: 
filename is the input file. The input file must be a 


linkable or library file. The file name must be 
specified according to operating system 
requirements. 


mod-name is the object modules or modules from the input 
file to be added to the target library. 


Abbreviation 


A 


Default 


ADD is not in effect. 


Description 


The ADD command lets you add input object modules to the target 
library. Only linkable object modules generated by 80386 compilers, 
assemblers, or other 80386 utilities can be added. The input file 
specified may contain a single object module or a sequence of object 
modules; or it may be another library file. The input file cannot have 
the same name as the library. ADD is executable only at the action 
command level. 


Unless modules are specified in parentheses, all modules in the input 
file are added to the target library. This is true whether or not the 
input file is a library. The target library may be initialized with the 
invocation line, or with the GET command at the initial level for the 
current LIB386 session. If modules are specified in parentheses, only 
the specified modules are added to the target library. 
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ADD (continued) 


Uninitialized global variables in C modules are BSS, not publics. (To 

make them publics, you must initialize them.) BSS variables are not 

used by BND386 or the builder to pull in library modules, which are 

not otherwise required to satisfy known externals. Oo 


A module in an object library is active if it is both logically and 
physically available. (See the DELETE entry in this chapter for 
details.) When a module specified with the ADD command is not 
active in the input file, the following error message appears at the 
console: 


MODULE NOT FOUND 
FILE: filename 
MODULE: mod-name 


If the specified module name is identical to the name of a module 
already in the target library, the module is not added to the library. 
The following error message appears at the console: 


DUPLICATE MODULE 

FILE: filename 

MODULE: mod-name oO 
If a public symbol name in the specified module is already active in 


the target library, the module is not added to the library. The 
following error message appears at the console: 


DUPLICATE PUBLIC 

FILE: filename 

MODULE: mod-name 

PUBLIC SYMBOL: public symbol name 


If ADD is for a single object file that is invalid, LIB386 does not add 
any modules from the file. If ADD is for two or more files and only 
one of the files is invalid, LIB386 adds modules from all files but the 
invalid file. 


In either case, LIB386 continues processing and the following error oO 
message appears at the console: 


INVALID OBJECT FILE 
FILE: filename 
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ADD (continued) 


If ADD is attempted for a file generated by an 80286 compiler, 
assembler, or utility, the following error message appears at the 
console: 


oO INPUT FILE IS A 286 OBJECT FILE 
FILE: filename 


Examples 


1. In the following examples, all the modules in the files MOD1.OBJ 
and MOD2.OBJ are added to the target library. 


DOS or VMS: %**XADD MOO1.0BJ, MOD2.OBJ 


2. In the following example, FILE1.LIB is a library file. MODI and 
MOD2 from this input file are added to the target library. 


DOS or VMS: *XA FILE1.LIB(MOD1, MOD2) 


* 
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BACKUP 


Enables or suppresses backup file 
for target library file 


Syntax 


DOS or VMS: BACKUP 
NOBACKUP 


Abbreviations 
BU 


NOBU 


Default 


BACKUP 


Description 


The BACKUP command tells LIB386 to create a backup file before the 
start of each library session. When BACKUP is used with the GET 
command, LIB386 copies the current contents of the target library file 
to the backup file before the session begins. Backup files have the 
same file name as the target library, with extension .LBK. 


BACKUP and NOBACKUP are the only LIB386 commands that remain in 
effect during all sessions under a single LIB386 invocation. 


The BACKUP command can be executed in the invocation line or at the 
initial command level. See Section 3.5 for more information on using 


BACKUP or NOBACKUP in the invocation line. 


NOTE 


On VMS systems, you get two backup files when the BACKUP 
control is used; one is maintained by the VMS system; the 
other is maintained by LIB386. 
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* 


*) 


BACKUP (continued) 
Examples 


1. In the following examples, the library file MOD2.LIB is 
initialized, and the GET control identifies this file as the target 
library file. BACKUP is specified; therefore, LIB386 copies 
MOD2.LIB to the backup file MOD2.LBK when the library file is 
initialized for the session. 


DOS or VMS: *BU 


*GET MOO2.LIB 
target library : FROUTINES X110 05/15/86 


2. In the following examples, no backup files are created during this 
invocation of LIB386. 


DOS: L1B386 MOD1.LIB NOBU 


VMS: L1B386/NOBU MOD1.LIB 
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COMPRESS 


Physically removes deleted 
modules from target library 


Syntax oO 


DOS or VMS: COMPRESS 


Abbreviation 


Cc 


Default 


COMPRESS in not in effect. 


Description 


The COMPRESS command physically removes data that has already Oo 
been logically deleted or replaced. Execute COMPRESS after you have 
executed several deletes and/or replaces; this will give LIB386 and 

other 80386 utilities faster access to the target library. 


The DELETE command logically deletes a module but does not 
necessarily physically remove it from the target library file. You can 
use the COMPRESS command to physically remove the module from the 
object library. See the description of the DELETE command for more 
information. 


COMPRESS is executable only at the action command level. 


Example 
In the following example, the target library is compressed by 
executing COMPRESS at the action command level. The target library oO 


is restructured for maximum efficiency. 


DOS or VMS: *kC 
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DELETE 
Logically removes modules 
from target library 


e) Syntax 


DOS or VMS: DELETE lseliaatael Abe | 
* 
Where: 
mod-name is the module to be deleted from the target 
library. 

* deletes all modules from the target library. 
Abbreviation 

D 


Oo Default 


DELETE is not in effect. 


Description 


The DELETE command logically removes specified modules from the 
target library. Public symbols in deleted modules are also logically 
removed. DELETE does not physically remove the modules, but there is 
no way to refer to modules that have been deleted. Use the 
COMPRESS command to physically remove modules that have already 
been logically deleted. 


When you are in foreground mode and specify, "delete all modules" 
with the construction, DELETE (*), LIB386 queries: 


oO Are you sure? [Y/N] 
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DELETE (continued) 


Type y or yes to confirm that you want to delete all modules. Any 

response besides y or yes causes LIB386 to ignore the DELETE 

command and issue the action command level prompt (**). In batch 

mode, you will not have the opportunity to confirm; LIB386 will 

delete all modules upon command. oO 


An object library module is active if the module is both logically and 
physically available. For each non-active module you specify, the 
following error message is displayed: 


MODULE NOT FOUND 
FILE: filename 
MODULE: mod-name 


DELETE is executable only at the action command level. 


Examples 
1. In the following examples, MODI and MOD2 are logically 
deleted from the target library. 
DOS or VMS: %*XD MOD1,MOD2 a) 
2. In the following examples, LIB386 deletes all modules from the 
target library. 


DOS or VMS: *xD * 
Are You Sure? [Y/N] y 
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FIND 


Searches target library 
for public symbol 


oO Syntax 


DOS or VMS: FIND symbol[,...] 
Where: 
symbol is the name of the public symbol that LIB386 is 


to search for in the target library. 


Abbreviation 


F 


Default 


Oo FIND is not in effect. 


Description 


The FIND command first verifies whether the specified public symbol 
is active (that is, logically and physically available) in the target 
library. If the symbol is active, the symbol name and the name of the 
module containing the symbol are displayed. 


If the symbol is not active in the target library, the following message 
appears at the console: 


public symbol, NOT FOUND 


Where 
public symbol is the specified public symbol. 
Oo FIND is executable only at the action command level. 
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FIND (continued) 
Examples 


1. In the following examples, CHKSTATUS is the public symbol 
that is searched for in the target library. The search finds 
CHKSTATUS in CHECKMOD. oO 


DOS or VMS: **F CHKSTATUS 
CHKSTATUS, IN MODULE CHECKMOD 


2. In the following examples, the search for CONVRBYTE finds 
that this public symbol is not active in any of the target library’s 
modules. 


DOS or VMS: *XF CONVRBYTE 
CONVRBYTE, NOT FOUND 


3. In the following examples, the search for symbols A and B finds 
that both are active in the target library’s modules. 


DOS or VMS: *KF A,B 
A, IN MODULE X 


B, IN MODULE Y 
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GET 


Initializes target 


library file 
ie) Syntax 
DOS or VMS: GET filename 
Where: 
filename is the library file that contains the target 


library. The file name must be specified 
according to the host operating system 
requirements. 


Abbreviation 


G 


O Default 


GET is not in effect. 


Description 


The GET command initiates a LIB386 session with the specified 
library file as the target library. All subsequent modifications, such 
as deletions and additions, affect the target library. 


After executing GET, LIB386 does the following: 


e Transfers control to the action command level, giving access to 
most LIB386 controls. 


e Signals the start of the LIB386 session by identifying the target 
library with the target library banner, which contains the name, 
version number, and last date of modification of the target 

Oo library. 
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GET (continued) 


The library file is automatically checked for read and write mode. If 
the target library is write-protected, the GET command is successfully 
executed, but the following warning appears at the console: 


**XWARNING: TARGET FILE IS WRITE PROTECTED a) 


You can use GET to create a new library file: specify a new library 
file name, and then add modules with the ADD command. Use the 
SET command to set the name and version number of the library. 
The banner displayed for a new library is as follows: 


TARGET LIBRARY: [new-library] date-and-time-last- 
modified 


To get another library file, you must first terminate the current 
session with the QUIT command before you can request another GET. 


GET is executable only at the initial option level. 


Examples 
1. In the following examples, LIB386 initiates the library file named oO 
MOD2.LIB. FPFUNCTIONS is the target library for this session. 
DOS or VMS: *G MOD2.LIB 
TARGET LIBRARY: FPFUNCTIONS X110 01/01/1986 10:04:55 
2. In the following examples, a new library file, MOD3.LIB, is 
created, because this file does not already exist. 


DOS or VMS: *G MOD3.LIB 
TARGET LIBRARY: [new library] 09/17/86 11:45:07 
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HELP 


Summarizes LIB386 commands, 
keywords controls 


oO Syntax 


DOS or VMS: HELP 


Abbreviation 


H 


Default 


The HELP summary is not displayed. 


Description 
oO The HELP command displays a summary of LIB386 commands. The 
summary lists each LIB386 command and control with the command 
syntax, abbreviation, and a brief description of its function. 


HELP summaries are available on the following topics: 


ABORT ADD BACKUP COMPRESS DELETE 
EXIT FIND GET HELP INITIALIZE 
LIST NAME PAGELENGTH PUBLICS QUIT 
REPLACE SET UPDATE VERSION 


The HELP command is available at both the initial and action 
command levels. 


Example 
In the following example, the HELP command summary is requested. 


DOS or VMS: *H 
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LIST 


Lists module names 


of library files 
Syntax we) 
DOS or VMS: LIST ([filel] [(mod-name)]}[,...] [TO file2] 
[PUBLICS] 
Where: 
filel is the name of the library file whose module 
information is to be listed. 
mod-name is the module or modules to be listed. If no 
modules are specified, all modules in the file 
are listed. Module names should be separated 
by commas: for example, mod-namel, mod- 
name2, 
file2 is the output print file. 
PUBLICS lists all public symbols in the specified modules. we) 


Abbreviation 


L 


‘Default 


If filel is not specified at the action command level, the target 
library is used. If TO file2 is unspecified, list information is 
displayed at the standard output device. 

The listing defaults are as follows: 

e The names of all modules in the library are listed. 


e Public symbol names are not listed unless the PUBLICS control is 
specified. oO 


e The first portion of the list appears 23 lines per page in NOBATCH 
mode. The listing is continuous in BATCH mode. The listing is 
also continuous if file2 is specified. 
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Oo 


LIST (continued) 


Description 


The LIST command displays the names of library modules and, as a 
control, public symbols on the standard output device. When using 
LIST at the initial command level, you must specify filel, because 
no target library has yet been initialized. At the action command 
level, filel defaults to the target library if not specified. 


You can obtain a list of public symbols in an object module by 
specifying mod-name and the PUBLICS control. You can also verify 
that a particular module resides in the specified or default library by 
specifying the name of only one module without PUBLICS. LIB386 
prints the module name if the module is in the library. 


In both foreground and background modes, LIST first identifies the 
library being listed by printing a library identification banner. 


In foreground mode, LIST prints the first page of the listing and then 
waits for input from the keyboard to determine how the next page or 
line is to be displayed. Use the following display controls: 


e  P--Displays one page at a time (the default) 

e  \L--Displays one line at a time 

e F--Displays with no breaks 

° E--Ends display, immediately terminating LIST command 
processing. 


When an input character other than P, L, F, or E is entered, LIB386 . 
continues to list in the previous display mode. 


You can set page length with the SET control. See the SET entry in 
this chapter for details. 


In background mode, or when the TO file2 control is specified, 
LIB386 prints the full list of modules and, if requested, public 
symbols. The display controls are unavailable. 


To obtain listings for other libraries without exiting from the current 
session, specify the desired library’s file name with the LIST 
command. 


LIST can execute at both the initial and action command levels. 
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LIST (continued) 
Examples 


1, In the following examples, the target library’s three module 
names are printed at the standard output device. 


DOS or VMS: KEL © 


TARGET LIBRARY : FPFUNCTIONS X110 01/01/1986 02:45:07 
M001 
Moo2 
M003 


2. In the following examples, MOD1.LIB’s module names and public 
symbols are printed to a file. 


DOS or VMS: *L MOO1.LIB TO Z.LST P 
File Z.LST contains the following: 


NON-TARGET LIBRARY : LIBABC 1.2 12/04/86 06:54:34 

MOD1 
PUBA 
PUBB 

woe  #) 
PUBC 


3. In the following examples, LIB386 verifies that the specified 
module is in the target library by displaying its name. 


DOS or VMS: **L (MOD1) 


TARGET LIBRARY =: FPFUNCTIONS X110 01/01/1986 07:07:15 
MOD1 
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QUIT 


Terminates current 


session 
Oo Syntax 
DOS or VMS: QUIT] [ABORT 
EXIT 
INITIALIZE 
Abbreviations 
A 
QUIT E 
I 
Default 
oO The QUIT command is not in effect unless specified. If specified in 
background mode, EXIT is the default control for the QUIT command. 


In foreground mode, you must specify QUIT ABORT, QUIT EXIT, or 
QUIT INITIALIZE; there is no default control. 


Description 


The QUIT command terminates the current LIB386 session. Three 
optional controls, ABORT, EXIT, and INITIALIZE, are available. 


When QUIT is specified at the action command level, LIB386 
identifies the current target library by displaying the target library 
file and the library banner, as follows: 


filename library-name version-number date-time-last- 
modified 


*) If the QUIT command is issued from the initial command level, no 
sign-off message is displayed. 
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QUIT (continued) 


In foreground mode, LIB386 queries for a control if none is specified 
with the QUIT command. The QUIT command is ignored if any 
character other than A, E, I, or the unabbreviated form of these 
controls is entered. If A, E, or I is specified, LIB386 proceeds 
through the appropriate quit sequence as explained below. 


In background mode, LIB386 does not query for a control if none is 
specified with the QUIT command. If changes were made to the 
library file, an update is made automatically before the exit. ABORT 
and INITIALIZE are available only if specified with the QUIT 
command (for example, QUIT ABORT). 


The ABORT control aborts update and transfers control to the operating 
system level. However, in foreground mode, if an update is required, 
the following query is displayed: 


ALL Changes Lost, OK? [Y/N] 


Select yes or y to complete the abort process and transfer control to 
the operating system level. All changes to the target library since the 
last update are lost. Select no, n, or any character other than y to 
cancel the QUIT command. Control remains at the action command 
level. 


The EXIT control updates the target library. LIB386 does not query, 
and control is transferred to the operating system. In BATCH mode, 
EXIT is the default control. 


The INITIALIZE control begins another session, transferring control 
from the action command level to the initial command level. At this 
point you can initialize another library file at the initial command 
level with the GET command. 


When the INITIALIZE control is specified, LIB386 checks to see if 
the target library needs to be updated. If so, the following query is 
displayed: 

ALL Changes Lost, OK? [Y/N] 
Select yes or y to transfer control from the action command level to 


the initial command level. All changes made to the target library 
since the last update are lost and a new LIB386 session is initiated. 
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oO 


* 


*) 


QUIT (continued) 


Enter no, n or any character other than y to direct LIB386 to ignore 
the QUIT command. Control remains at the action command level. 
(You can issue the UPDATE command, then reissue the QUIT 
command.) 


The QUIT command is executable at the initial and action command 
levels. 


Examples 


1. In the following examples, the current session is aborted. LIB386 
discovers that NEWLIB-NAME has been altered since the last 
update and queries: 


ALL Changes Lost, OK? [Y/N] 


Yes is selected, instructing LIB386 to ignore the changes and 
complete the abort process. LIB386 returns control to the 
operating system. 


DOS or VMS: **O A 
MOD1.LIB, NEWLIB-NAME V1.1 11/25/1986 01:03:08 
ALL Changes Lost, OK? [Y/N] y 


2. In the following examples, DRIVERS is the target library name. 
In foreground mode, LIB386 prompts for a control. INITIALIZE 
is specified and y is the response to the query: 


All Changes Lost, OK? [Y/N] 
LIB386 returns to the initial command level from the action 


command level. 


DOS or VMS: * QUIT 
MOD2.LIB, DRIVERS 2293 11/25/1986 12:05:45 
Abort) /E(xit)/I(nitialize) = 1 
All Changes Lost, OK? [Y/N] y 
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REPLACE 


Replaces module from target library 
with module(s) from another object file 


Syntax oO 


DOS or VMS: REPLACE mod-namel BY filename[ (mod- 
name2[,...])] 


Where: 

mod-namel is the name of the module to be replaced in the 
target library. 

filename is the input object file to be added to the target 
library, or the file containing mod-name2. 

mod-name2 is the name or names of the module or modules 


to be added to the target library. 


Abbreviation 


R oO 


Default 


REPLACE is not in effect. 


Description 


The REPLACE command logically deletes a module from the target 
library and replaces it with one or more modules from the input 
object file. Unless specific module names are listed with the input 
object file, all modules in that file are added to the target library. 


If mod-namel and mod-name2 are not found, the replacement is not 
made; the target library remains unchanged. The following error 
message is displayed at the console: 


MODULE NOT FOUND 


FILE: filename 
MODULE: mod-name 


3-38 Using the 80386 Librarian 


REPLACE (continued) 


If a public symbol name in the input module is already in the target 
library, the module is not added to the target library. 


REPLACE is executable only at the action command level. 


* 


Example 


In the following example, LIB386 replaces MODS in the target library 
with MODI from the input object file. 


DOS or VMS: %**R MOOS BY MOD1.LIB (MOD1) 
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SET 


Changes name, version number, 
or page length of listing 


Syntax  ) 


DOS or VMS: SET | (NAME = library-name 
VERSION = version-number 
PAGELENGTH = lines 


Where: 

NAME is the keyword that sets the name of the target 
library. 

library-name is the name of the library. The library-name 
can be up to 40 characters long. 

VERSION is the keyword that sets the version number of 
the target library. 

version-number is the version number, up to four characters 
long. oO 

PAGELENGTH is the keyword that sets the length of a page of 
listing. 

lines is the number of lines in a page of listing, from 


1 to 65535 (decimal). 


Abbreviations 


Default 
NAME: one blank space in the library banner. Before the SET 
command is used to name the target library, LIB386 displays the O 


target library name as blank spaces in the library banner. 
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SET (continued) 
VERSION: four blank spaces in the library banner. 


PAGELENGTH: 23 lines. 


oO Description 


* 


The NAME command lets you change the name of the target library. 
The library name can be a string up to 40 characters long. A syntax 
error occurs if the specified name exceeds the maximum number of 
characters. When this happens, LIB386 does not change the old name. 


You can change the version number of the target library using the 
VERSION control. The version number can be a string up to four 
characters long. A syntax error occurs if the specified number 
exceeds the maximum number of characters. When this happens, 
LIB386 does not change the old number. If less than the maximum 
number of characters is used, the version number is left-justified and 
padded with blanks. 


You can specify the number of lines in a page generated by the LIST 
command using the PAGELENGTH control. The page length can be 
from 1 to 65,535 lines. A syntax error occurs if the specified page 
length exceeds the maximum number of lines. When this happens, 
LIB386 does not change the old page length. 


To make multiple specifications (e.g., for a library name and a version 
number) with the same execution of SET, separate one specification 
from the next with a comma. If the same control is specified twice in 
one line, the rightmost specification takes effect. 


When you enter the SET command without controls, LIB386 responds 
by prompting for SET specifications. Press the return key to cause 
LIB386 to issue successive prompts for NAME, VERSION, and 
PAGELENGTH. LIB386 displays the following prompts, in the sequence 
shown: 


NAME = current-library-name. NEW VALUE: 

VERSION = current-version-number. NEW VALUE: 

LIST command PAGELENGTH = current-page-length. NEW 
VALUE: 
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SET (continued) 


To change a specification, enter the new name, version number, or 
page length at the prompt. 


press the return key. After the PAGELENGTH prompt, LIB386 displays 


To retain the current specification and proceed to the next prompt, 
the library banner and returns to the action command level. © 


LIB386 displays the new banner for the target library after the SET 
command has successfully completed. 


Once specified, the target library name and number can be changed 
only with the SET command. The following characters can be used in 
library names and versions: 


e All alphanumeric characters 

e ©The following characters: @.? _ 

e Other characters provided they are enclosed by apostrophes (’) or 
double quotation marks ("). 


It is recommended that alphanumeric characters be used, because 
some operating systems may not accept non-alphanumeric characters. © 


The SET command is executable only at the action command level. 


Examples 


1. In the following examples, X20! is set as the version number of 
the target library. LIB386 immediately displays the new banner 
for COMMONLIB. 


DOS or VMS: **SET VERSION = X201 
TARGET LIBRARY: COMMONLIB X201 04/23/1986 06:04:05 
2. In the following examples, PASCALIB and X100 are set as the 
name and version number of the target library. 


DOS or VMS: **S N = PASCALIB, VERSION = X100 
TARGET LIBRARY: PASCALIB X100 05/06/1986 11:09:45 oO 
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SET (continued) 


3. In the following example, a carriage return is entered after the 
SET command. LIB386 prompts for the name, version number, 
and page length of the target library. In this example, only the 
version number is changed. 


 ) DOS or VMS: wks 


NAME = LIB1. NEW VALUE: 

VERSION = 1. NEW VALUE: 2 

LIST COMMAND PAGE LENGTH = 23. NEW VALUE: 
TARGET LIBRARY: LIB1 2 12/02/1986 10:45:07 
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UPDATE 


Updates current 
target library file 


Syntax © 


DOS or VMS: UPDATE 


Abbreviation 


U 


Default 


UPDATE is not in effect. 


Description 
The UPDATE command writes the contents of the target library to the oO 
target library file. A target library file can be updated at any time 
during a session. 


When you attempt to update a write-protected target file, LIB386 does 
not update the file and issues the following message: 


ATTEMPT TO UPDATE WRITE-PROTECTED FILE 


Updating the target library does not terminate the session: you must 
use the QUIT command after UPDATE to end the session. 


UPDATE is executable only at the action command level. 
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UPDATE (continued) 
Example 


In the following example, the GET command initializes FILE1.LIB as 
the target library file. The object file MOD2.OBJ is added to the 

oO target library FPFUNCTIONS. UPDATE incorporates this change into 
FILE1.LIB. The QUIT command ends the session. 


DOS or VMS: **G FILE1.LIB 
TARGET LIBRARY: FPFUNCTIONS X201 04/05/1986 10:22:43 
**A MOD2.0BJ 
#wkYU 
eq 1 
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3.8.1 
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Using LIB386: Examples 


Figures 3-3, 3-4, and 3-5 show examples of LIB386 use. 


Single Session 
Figure 3-3 is an example of a single library session in foreground 


mode. In this example, only one target library is processed before the 
QUIT command is invoked and LIB386 is exited. 
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LIB38b COMMON-LIB <cr> 
system-id 80384 LIBRARIAN. Vx-yVX 
Copyright year(s) Intel Corporation 
TARGET LIBRARY = COMMONLIB X010 O2/02/4b 
**ADD INIT-OBu. ERRH-OBU = <cr> 
**ADD UTIL-LIB(GETFLP.GETINT) <cr> 
**kDELETE STRCHK <cr> 
**REPLACE START BY OLD-LIB(STARTUP) <cr> 
**FIND OVRERR <cr> 
OVERR, IN MODULE SETLST 
**LIST PUBLICS <cr> 
COMMONLIB XO10 2/2/1986 
TonoD 
PUBLINIONOD 
PUB2INIONOD 
PUB3INIONOD 
PUBYINIONOD 
PACMAN 
WEIRDNOISE 
COLOREXTRAVAGANZA 
WASTEMONEY 
SETLST 
OVRERR 
PUBINSETLST 
GETFLP 
PUBLINGETFLP 
PUBCINGETFLP 
PUBAINGETFLP 
GETINT 
PUBINGETINT 
STARTUP 
STARTANDKILL 
**SET VERSION = XOL1 <cr> 
COMMONLIB XO11 02/02/1586 10:48:20 
ACBORT)/ECXIT)/ICNITIALIZE) = E <cr> 


S MODULES ADDED. 2 MODULES DELETED 


m-0552 


Figure 3-3 Foreground Execution Example: A Single Session 
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3.8.2 Multiple Session 


Figure 3-4 is an example of a multiple library session in foreground 

mode. In this example, several libraries are sequentially processed, 

using the QUIT command with the INITIALIZE command to transfer oO 
control from the action command level to the initial command level. 

At the initial command level, the GET command initializes another 

library as the target library for the next session. 


LIB38b <cr> 
system-id 80386 LIBRARIAN. Vx-yVX 
Copyright year(s) Intel Corporation 


*GET FIRST-LIB <cr> 

TARGET LIBRARY =: MAINLIB XO0O1 04/03/1986 9:40:07 

**ADD IOPROC-OBU (CIO_DRIVER) <cr> 

**kDELETE DUMMY_IO_PROC <cr> 

**SET VERSION = XO0e2 <cr> 

MAINLIB XOO0e 04/03/1986 9:40:20 

**kUPDATE <cr> 

**QUIT <cr> 

FIRST-LIB. MAINLIB XO02 04/03/1986 F:4L:1b oO 
A(bort)/E(xit)/I(nitialize) = I <cr> 


1 MODULE ADDED, 1 MODULE DELETED 
**GET OVERLY-LIB <cr> 


TARGET LIBRARY :SUBROUTINES X00 03/02/1986 9:42:42 
**kADD NEWMOD-OBJ (LPDRIVE) <cr> 

*XUPDATE <cr> 

**QUIT<cr> 

OVERLY-LIB, SUBROUTINES X001 04/03/1986 9:43:42 
A(bort)/E(xit)/I(nitialize) = E <cr> 


L MODULE ADDED. O MODULES DELETED 


Figure 3-4 Foreground Execution Example on DOS: Multiple Sessions 
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LIB38b <cr> 
system-id 80386 LIBRARIAN, Vx-yVX 


Copyright year(s) Intel Corporation 


*GET FIRST-LIB <cr> 

TARGET LIBRARY : MAINLIB XO00O1 O4/03/198b 9:40:07 
*xADD IOPROC-OBU (IO_DRIVER) <cr> 

*kDELETE DUMMY_IO_PROC <cr> 

**SET VERSION = X002 04/03/1986 9:40:07 

*x*UPDATE 

*KQUIT 

MAINLIB XOOL 04/03/1986 9:41:01 
ACBORT)/EC(XIT)/ICNITIALIZE) = I <er> 


1 MODULE ADDED, 1 MODULE DELETED 
*GET SECOND-LIB <cr> 


a) Figure 3-5 Foreground Execution Example on VMS: Multiple Sessions 


3.8.3 Background Session 


Figure 3-6 illustrates LIB386 background execution. In this example, 
a command file called MAKELIB.COM contains the following: 


e The LIB386 invocation line, which initializes NEW.LIB as the 
target library and invokes BATCH mode 
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e The processing commands ADD (used twice) and COMPRESS 


e The QUIT command to terminate execution 


The contents of the DOS command file MAKELIB.BAT are as 
follows: 


L1B386 NEW.LIB BATCH < MAKLIB.DAT 
The contents of the DOS input file MAKLIB.DAT are as follows: 


ADD UDI .OBJ(UDI-PROC) 
ADD\MARK\LIB386\TEST\LKS\LKSLRG.T01 
COMPRESS 

QUIT EXIT 


Figure 3-6 shows the MAKLIB.BAT file invocation and the sign-on 
and sign-off messages LIB386 displays. 


The contents of the VMS command file MAKELIB.COM are as 
follows: 


$ LIB386/BATCH NEW.LIB © 


ADD UDI .OBJ(UDI-PROC) 
ADD LKSLRG.T01 
COMPRESS 

QUIT EXIT 

$ 


Figure 3-6 shows the MAKLIB.COM file invocation and the sign-on 
and sign-off messages LIB386 displays. 


LIB38b <cr> 
system-id 80386 LIBRARIAN. Vx-yVX 
Copyright year(s) Intel Corporation 


*GET FIRST-LIB <cr> 
TARGET LIBRARY : MAINLIB XOO1 04/03/1985 9:40:07 

*KADD IOPROC-OBU (IO_DRIVER) <cr> oO 
*kDELETE DUMMY_IO_PROC <cr> 


Figure 3-6 Background Execution Example on DOS 
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Figure 3-7 illustrates LIB386 background execution on VMS. In this 
example, a command file called MAKELIB.COM contains the 
following: 


$L1B386/BATCH NEW.LIB 
ADD UDI.OBJCUDI - PROC 
ADD LKSLRG.TO1 
COMPRESS 

QUIT EXIT 

$ 


Figure 3-7 shows the MAKLIB.COM file invocation and the sign-on 
and sign-off messages LIB386 displays. 


= OMAKELIB.COM 

= LIB38b/BATCH NEW-LIB 
ADD UDI-OBJCUDI_PROC) 
ADD 4LS5RG/TOL 
COMPRESS 

QUIT EXIT 


system-id 80346 LIBRARIAN Vx-yVX 
Copyright year(s) Intel Corporation 


TARGET LIBRARY: [new library] Oe/Oe/ab OFFe2:17 
KKK KKK KK 
NEW-LIB, Oe/0e/8b O494:22:17 


1 MODULE ADDED. 1 MODULE DELETED 


Figure 3-7 Background Execution Example on VMS 
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Chapter 4 
Using the 80386 Mapper 


The MAP386 mapper produces printed information about object 
modules, including cross-reference maps, and, at your request, purges 
debug information from the object modules. 


MAP386 accepts, as input, object files created by other 80386 
utilities, BND386, BLD386, and LIB386, or by 80286 utilities (except 
for 80286 loadable modules). Input files can be linkable files, library 
files containing linkable modules, or loadable files containing loadable 
or bootloadable modules. You can also specify individual linkable 
modules within linkable or library files as input to MAP386. 


Major Functions of MAP386 


MAP386 performs the following major functions for loadable input 
files: 


e Removes selected debug information, that is, information about 
public, external and local symbol declarations, and lines of source 
code that are used by software debuggers. 


e Generates printed output that describes the contents of the input 
file. This output can include: 


— Module list 

— Table map 

— Segment map 

— Gate map 

— Symbol map 

— Public map 

— Task map 

— Cross-Reference map 


e Inserts information for the target operating system. 


4.2 


Input and Output 


MAP386 accepts the following as input: 


e One loadable file (containing a single loadable or bootloadable 
module) produced by one of the 80386 utilities, or one or more 
linkable and/or library files (containing one or more linkable 
modules. (See Figure 4-1.) For non-loadable object modules, 
you may specify 80386 and 80286 object files in the same 
invocation. 


e One or more MAP386 invocation controls described later in this 
chapter. 


e Operating system information (osinfo) file if the input is loadable. 
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INVOCATION LINE, 
LOADABLE INPUT 


LOADABLE MODULE LIST 
INPUT FILE TABLE MAP 
(386) MAP386 SEGMENT MAP 
MAPPER GATE MAP 
SYMBOL MAP 
PUBLIC MAP 
TASK MAP 


Y CROSS- 
CONSOLE REFERENCE 
MESSAGES MAP 


OUTPUT OBJECT FILE (386) 
WITH DEBUG INFORMATION 


SELECTIVELY REMOVED AND 
WITH OSINFO ADDED 


INVOCATION LINE, 
LINKABLE INPUT 


286/386 
LINKABLE 
INPUT CIN MAP386 CROSS- 
LINKABLE MAPPER REFERENCE 
OR LIBRARY MAP 
FILES) | 


CONSOLE 
MESSAGES 


Figure 4-1 MAP386 Input and Output 


For loadable and linkable input files, MAP386 outputs the following 


lists, as shown in Figure 4-1: 


Module List 
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For linkable input, lists modules input to 
MAP386. For loadable modules, lists linkable 
modules that make up the expandable file 
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Cross-Reference 


Provides name and type of each symbol in the 
input file, name of the module containing the 
public definition, and names of modules 
containing external declarations for the symbol. 
The cross-reference map is the only map 
produced for linkable modules 


For loadable files, MAP386 includes the following information in the 
print output, as shown in Figure 4-1: 


Table Map 


Segment Map 


Gate Map 


Symbol Map 


Public Map 


Task Map 


Descriptor names and corresponding indexes for 
global descriptor table (GDT), interrupt 
descriptor table (IDT), and local descriptor 
tables (LDTs) 


Names of segments in the input file and 
characteristics of each segment, such as 
descriptor table index, access type, base, 
descriptor privilege level (DPL), USE16/32 
attributes, align attributes, and others 


Symbolic gate names and characteristics of each 
gate in the input file, such as descriptor table 
name, descriptor table index, gate type, and 
others 


Names of local symbols in the input file and 
characteristics of each symbol, such as symbol 
type, address, and others 


Public symbols in the input file and their 
characteristics, such as symbol type, word 
count, and logical (and if applicable, physical) 
address 


Task characteristics for each task such as initial 
privilege stack, flags, initial values of CS and 
EIP registers, LDT selector of the task, and 
others 


The module list and each of these maps are described in more detail 


in Section 4.9. 


If the file input to MAP386 contains a loadable module, MAP386 
produces some or all of the following output, as specified by the 


input controls: 
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4.3.2 


e An output object file. Debug information, such as information 
about symbols and line numbers, can be removed from the output 
file. Information relating to the operating system can be added 
or updated. 


e_ 6A print file containing a module list and one or more of the 
following maps: 


— Table map 
— Segment map 
— Gate map 
— Symbol map 
— Public map 
— Task map 
e A cross-reference map that can be directed to the print file or 
another specified file. 


If the input file is linkable, MAP386 produces only a cross-reference 
map. The file containing the cross-reference map includes a module 
list. 


MAP386 Module Processing 


Executable Modules 


Executable files input to MAP386 contain a single loadable module 
produced by a 80386 utility. MAP386 accepts only one loadable input 
file per invocation. 


Linkable Modules in Linkable Files 
MAP386 processes modules in linkable files as specified in the 


invocation line. MAP386 can process linkable files produced by any 
80286 or 80386 compiler, assembler, or utility. 
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4.3.3 Linkable Modules in Library Files 


MAP386 processes linkable modules in library files if they are 

explicitly specified in the invocation line or if they resolve external 

references made in modules previously processed during the same oO 
MAP386 invocation. 


The processing of an input file varies depending on whether it is a 
library or non-library file. A non-library file may contain one object 
module or several object modules concatenated by BND386 or the 
BLD386 System Builder. Since several modules cannot reliably be 
concatenated with a copy command, a library file contains control 
information in addition to object modules. A module in a non-library 
file is processed by MAP386 if it is explicitly listed in the module list 
or if the module list is not specified. 


Processing a library file is more complicated. If a module list is 

specified for the library file, it is processed in the same manner as a 
non-library file. If a module list is not specified, the library file is 

processed only if the previously processed modules contain an 

unresolved external. The library is scanned for modules containing 

public symbols that match as-yet unresolved externals. Each such #) 
module is processed as if it has been explicitly specified. The 

selection process continues until the modules in the library cannot 

satisfy any more unresolved externals (including externals encountered 

while processing modules from the library). 
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4.4.1 


4.4.2 


Invoking MAP386 


DOS Invocation Syntax 


To invoke MAP386 on a DOS operating system, use the following 
syntax: 

MAP386 input-list [controls] 
Where: 


input-list is one or more linkable modules or object 
library modules, specified as follows: 


filename || [(: & ‘] 


* An asterisk (*) specifies all modules in the file 
named by filename. 


controls is one or more of the MAP386 specifications 
described later in this chapter. 


When you are working with loadable files, you must specify the input 
list with the file name only; you cannot specify module names. 
MAP386 accepts only one input file in this case. 


You can continue the invocation line on additional lines by typing the 
ampersand (&) before the line terminator. This character causes the 
continuation line to appear with the DOS prompt character. 


VMS Invocation Syntax 


To invoke MAP386 on a VMS operating system, use the following 
syntax: 


MAP386[/controls] input-list 
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Where: 


input-list is one or more linkable modules or object 
library modules, specified as follows: 


ee || " [(: a ‘| 


* An asterisk (*) specifies all modules in the file 
named by filename. 


Note that if an input list is specified, filename 
and mod-name or filename and * should be 
enclosed in double quotation marks ("). 


controls is one or more of the MAP386 specifications 
described later in this chapter. 


When you are working with loadable files, you must specify the input 
list with the file name only; you cannot specify module names. 
MAP386 accepts only one input file in this case. 


You can continue the invocation line on additional lines by typing the 
ampersand (&) before the line terminator. This character causes the 
continuation line to appear with the VMS prompt character. 


Control Files 


The BND386 invocation line is simplified when you can use the 
CONTROLFILE control to invoke a control file. A control file is a text 
file containing any file names or controls that would normally appear 
in the invocation line. For example, instead of listing five controls in 
the BND386 invocation line, you can place those controls in a single 
control file and then invoke the control file in place of all five 
controls. 
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4.5.1 


Using a Control File on DOS 


To include a control file in the MAP386 invocation line for a DOS 
operating system, use the following syntax: 


MAP386 CONTROLFILE (filename[,...]) 
Where: 


filename is the name of the control file containing 
controls, file names, or controls and file names 
for the input list. You cannot nest control files: 
that is, the CONTROLFILE control cannot appear 
in a control file. 


A control file that contains only controls can be specified in any 
position in the input list. A control file that contains only file names 
for the input list can be specified in any position in the input list. 


In a control file that contains both input files and controls, input files 
must come before controls. In this case, specify the control file as 
part of the input list. 


The following example shows how to specify the CONTROLFILE 
control in an input list that contains the files named in CF1.DAT: 


MAP386 MOD.OBJ, CONTROLFILE (CF1.DAT) DEBUG 


Within a control file, use a semicolon before a comment. Use the 
ampersand (&) to continue to the next line. When the line terminator 
comes before the ampersand, it is treated as if it were a blank space. 
MAP386 ignores characters between a semicolon or continuation 
character and the line terminator. Lines in a control file cannot 
exceed 120 characters in length. 


This example control file contains only file names for the input list: 


util.lib, 
system. lib 


utility library& 
system library 


ses 
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4.5.2 


This example control file contains the last file names for the input list 
and controls for the control list: 


util. lib, ; utility library& 
system. lib system library& 
lo loadable module& 
ep directs error messages& 


to the specified print& 
file speci fied& 
name output file 


mee Se Se we 


oj (lbt.sys) 


a 


Using a Control File on VMS 


There are two ways to include a control file in the MAP386 
invocation line on a VMS system, depending on whether the control 
file contains only controls or it contains file names for the input list. 


To include a control file that contains controls only, use the 
following syntax on the MAP386 invocation line: 


MAP386/CONTROLFILE = (filename[,...]) 
Where: 


filename is the name of the control file containing 
controls. You cannot nest control files: that is, 
the CONTROLFILE control cannot appear in a 
control file. When you are specifying a single 
control file, you can drop the parentheses 
around filename. 


To include a control file that contains only file names for the input 
list or file names and controls, use the following syntax on the 
MAP386 invocation line: 


MAP386 "CONTROLFILE (filename[,...])" 
Where: 


filename is the name of the control file containing file 
names for the input list. Note that you must 
enclose both the CONTROLFILE control and the 
file name or names in double quotation marks 
(") and enclose the file name in parentheses. 
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A control file that contains only controls can be specified in any 
position in the input list. A control file that contains only file names 
for the input list can be specified in any position in the input list. 


In a control file that contains both input files and controls, input files 
must come before controls. In this case, specify the control file in the 
input list. 


The following example shows how to specify the CONTROLFILE 
control in an input list that contains the files named in CF1.DAT: 


MAP386/DEBUG MOD.OBJ, "CONTROLFILE (CF1.DAT)" 


VMS NOTE 


On VMS systems, MAP386 controls can be abbreviated 
according to the VMS notation if their first four characters are 
unique. Otherwise, the control name must be used in full or 
abbreviated according to Table 4-3. 


For example, since the first two characters of the ERRORPRINT 
control are unique, the control can be abbreviated either as 
7ER or as /EP, the MAP386 abbreviation shown in Table 4-3. 
VMS systems do not consider the full control name and the 
MAP386 abbreviation in Table 4-3 to be the same control. 
Therefore, do not mix abbreviations and full control names on 
the same invocation line. 


Within a control file, use a semicolon before a comment. Use the 
ampersand (&) to continue to the next line. When the line terminator 
comes before the ampersand, it is treated as if it were a blank space. 
MAP386 ignores characters between a semicolon or continuation 
character and the line terminator. Lines in a control file cannot 
exceed 120 characters in length. 


This example control file contains only file names for the input list: 


util. lib, 7 utility library& 
system. lib 7 system Library 
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4.6.1 


This example control file contains the last file names for the input list 
and controls for the control list: 


util. lib, ; utility library& 
system. lib ; system Library& 
lo ; loadable module& 
ep directs error messages& 


to the specified print& 
file specified& 
name output file 


mee see 


oj (lbt.sys) 


MAP386 Defaults 


If the input file is a loadable module, MAP386 processes the single 
module. 


If the input file is linkable and no modules are specified in the input 
list, MAP386 processes all modules. 


If the input file is an object library and no modules are specified in 
the input list, MAP386 processes only the modules that satisfy 
external symbol references already encountered in the input. For a 
reference to be satisfied, a symbol must be declared public in a 
module in the library. 


Output Identifiers 


If no output file names are specified in the invocation line (with 
controls PRINT, OBJECT and ERRORPRINT), MAP386 creates output 
files as follows: 


¢ MAP386 produces a print file with the same file name as the 
input file and assigns the extension .MAP. 


e If the input file is loadable, and OBJECT, OBJECTCONTROL or 
OSINFO have been specified, MAP386 produces an output object 
file with the same file name as the input file and assigns the 
extension .OUT. 


e If ERRORPRINT is specified without a file name, all the error 
messages are printed to the console. 
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Controls 


When no controls are specified in the MAP386 invocation line, 
MAP386 performs the functions described below: 
When the input file is loadable, MAP386 does the following: 


e Produces a module list, table map, symbol map, gate map, public 
map, task map, and cross-reference map. These items and error 
messages are placed in a file with the same name as the input 
object file, with extension .MAP. 


When the input is a linkable file or modules, MAP386 does the 
following: 


e Produces a cross-reference map and places it along with a module 
list and error messages in a file with the same name as the input 
file and with the extension .MAP. 


Regardless of whether file input is loadable, bootloadable, or linkable 
MAP386 does the following by default: 


e Displays only fatal error messages on the console. 


e Produces output maps 120 columns wide with 60 lines per page. 
A header on each page includes a title, date, and page number. 


Console Messages 


MAP386 generates sign-on/sign-off messages and error messages on 
the console. 


MAP386 signs on to the system console with the following message: 


system-id 80386 MAPPER, Vx.y 
Copyright years, Intel Corporation 


Where: 

system-id identifies the host operating system. 
Vx. is the MAP386 version number 
years is the copyright year or years. 
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After processing is complete and if no fatal errors have occurred, 
MAP386 signs off as follows: 


PROCESSING COMPLETED.n WARNING(S) ,m ERROR(S) 
Where: 


n and mare the number of warnings and errors. 


Fatal error messages are always displayed. If MAP386 encounters a 
fatal error condition, an error message and the following sign-off 
message appears at the console: 


PROCESSING ABORTED 


Although nonfatal error messages are included in the print file by 
default, they can be directed to the console with the ERRORPRINT 
control. See the ERRORPRINT entry in this chapter for more 
information. 


MAP386 Controls 


Table 4-1 summarizes MAP386 controls for DOS operating systems. 
Table 4-2 summarizes MAP386 controls for VMS operating systems. 
The default column shows the condition in effect when the control is 
not specified. When an invocation contains duplicate control 
specifications, MAP386 processes only the rightmost specification on 
the invocation line. 


Table 4-3 lists abbreviations of MAP386 controls. Each MAP386 
control is listed alphabetically and described in detail in the section 
following Table 4-3. In the detailed descriptions, the controls labeled 
DOS are used for DOS command lines as well as for DOS and VMS 
control files. The controls labeled VMS are used for VMS command 
lines only. 
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Table 4-1 MAP386 Controls for DOS Operating Systems 


Command Line Syntax Description Default 


Specifies file for input 

elements 

Creates or suppresses NOERRORPRINT 
creation of error print file 


OBJECT [(filename)] Creates output object file If OBJECT 
NOOBJECT from loadable or CONTROLS or 
bootloadable input files OSINFO specified: 
OBJECT = (input- 
filename.OUT); 
otherwise, 
NOOBJECT 


OBJECTCONTROLS Includes or removes debug | OBJECTCONTROL 
(objectcontro! [EXCEPT](mod- | information in output object | (DEBUG) (Includes 
name{,...])]L.--]) file debug information) 


object controls: 

DEBUG NODEBUG 
EXTERNALS NOEXTERNALS 
LINES NOLINES 
PUBLICS NOPUBLICS 
SRCLINES NOSRCLINES 
SYMBOLS NOSYMBOLS 
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Table 4-1 MAP386 Controls for DOS Operating Systems (continued) 


Command Line Syntax Description Default 


OSINFO (filename) Creates or updates None 
operating system information 
section of object file 
PAGELENGTH (length) Sets lines per page for PAGELENGTH (60) 
output listing 
PAGEWIDTH (width) Sets characters per line for | PAGEWIDTH (120) 
output listing 
PAGING Creates page breaks in print | PAGING 
NOPAGING files 


PRINT (filename) Creates or suppresses PRINT (first-input- 
NOPRINT creation of print file filename.MAP) 


PRINTCONTROLS (printcontrol) | Includes or omits selected PRINTCONTROLS 
[EXCEPT}(moa-namef|....])[,...]) | maps from print file (DEBUG, TABLES, 
TASKS) 


print controls: 

DEBUG NODEBUG 
LINES NOLINES 
PUBLICS NOPUBLICS 
SRCLINES NOSRCLINES 
SYMBOLS NOSYMBOLS 
TABLES NOTABLES 
TASKS NOTASKS 
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Table 4-1 MAP386 Controls for DOS Operating Systems (continued) 


Command Line Syntax Description Default 


SYMBOLSORT Prints symbol names in SYMBOLSORT 
NOSYMBOLSORT alphabetical order 

(SYMBOLSORT) or in order 

of occurrence in 

(NOSYMBOLSORT) 


TITLE (title) Places header line at top of 
each print file page 


TYPE Ignores types TYPE 
NOTYPE 

TYPECHECK Enables or suppresses type | TYPECHECK 
NOTYPECHECK checking 


XREF [(filename)]} Directs intermodule cross- | XREF(print-file 
NOXREF reference map between filename) 
public and external symbols 
to specified file 
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Table 4-2 MAP386 Controls for VMS Operating Systems 


Command Line Syntax Description Default 


CONTROLFILE = filename Specifies file for input 

CONTROLFILE (filenamef....]) elements 

ERRORPRINT (= filename) Creates or suppresses NOERRORPRINT 
NOERRORPRINT creation of error print file 


OBJECT [(= filename)] Creates output object file lf OBJECT 
NOOBJECT from loadable or CONTROLS or 
bootloadable input files OSINFO specified: 
OBJECT = (input- 
filename.OUT); 


otherwise, 
NOOBJECT 


OBJECTCONTROLS = Includes or removes debug | OBJECTCONTROL 
(‘objectcontrol [EXCEPT](mod- | information in output object | (DEBUG) (Includes 
name|,...])]"L---]) file debug information) 


object controls: 

DEBUG NODEBUG 
EXTERNALS NOEXTERNALS 
LINES NOLINES 
PUBLICS NOPUBLICS 
SRCLINES NOSRCLINES 
SYMBOLS NOSYMBOLS 
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Table 4-2 MAP386 Controls for VMS Operating Systems (continued) 


Command Line Syntax 


OSINFO = (filename) 


PRINTCONTROLS = 
(‘printcontrol) [EXCEPT] (moa- 
name{,...])"[,-.-]) 


print controls: 
DEBUG 
LINES 
PUBLICS 
SRCLINES 
SYMBOLS 
TABLES 
TASKS 


NODEBUG 
NOLINES 
NOPUBLICS 
NOSRCLINES 
NOSYMBOLS 
NOTABLES 
NOTASKS 
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Description Default 


Creates or updates 

operating system information 

section of object file 

Sets lines per page for PAGELENGTH = 60 
output listing 

Sets characters per line for | PAGEWIDTH = 120 
output listing 

Creates page breaks in print | PAGING 

files 


Creates or suppresses PRINT = first-input- 
creation of print file filename.MAP 


PRINTCONTROLS 
(DEBUG, TABLES, 
TASKS) 


Includes or omits selected 
maps from print file 
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Table 4-2 MAP386 Controls for VMS Operating Systems (continued) 


Description Default 


Prints symbol names in SYMBOLSORT 
alphabetical order 
(SYMBOLSORT) or in order 
of occurrence in 
(NOSYMBOLSORT) 
TITLE = "title" Places header line at top of 
each print file page 


TYPE Ignores types TYPE 
NOTYPE 

TYPECHECK Enables or suppresses type | TYPECHECK 
NOTYPECHECK checking 


XREF [(= filename)]} 
NOXREF 


Command Line Syntax 


SYMBOLSORT 
NOSYMBOLSORT 


Directs intermodule cross- XREF = print-file- 
reference map between filename 

public and external symbols 
to specified file 
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VMS NOTE 


On VMS systems, MAP386 controls can be abbreviated 
according to the VMS notation if their first four characters are 
unique. Otherwise, the control name must be used in full or 
abbreviated according to Table 4-3. 


For example, since the first two characters of the ERRORPRINT 
control are unique, the control can be abbreviated either as 
7ER or as /EP, the MAP386 abbreviation shown in Table 4-3. 
VMS systems do not consider the full control name and the 
MAP386 abbreviation in Table 4-3 to be the same control. 
Therefore, do not mix abbreviations and full control names on 
the same invocation line. 


Table 4-3 Standard Abbreviations for MAP386 Controls 


Command 


CONTROLFILE 
ERRORPRINT 
NOERRORPRINT 
NOOBJECT 
NOPAGING 
NOPRINT 
NOSYMBOLSORT 
NOTYPE 
NOTYPCHECK 
NOXREF 
OBJECT 
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Command 


OBJECTCONTROLS 
OSINFO 
PAGELENGTH 
PAGING 

PRINT 
PRINTCONTROLS 
SYMBOLSORT 
TITLE 

TYPE 
TYPECHECK 
XREF 
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CONTROLFILE 


Specifies file for 
input elements 


Syntax ] 


DOS: CONTROLFILE (filename[,...]) 


VMS: /CONTROLFILE = (filename[,...]) 


Abbreviation 


CF 


Default 


CONTROLFILE is not in effect. 


Description © 


The CONTROLFILE control directs MAP386 to the specified file for 
controls or elements of the input list. A partial control or input list 
element is not allowed. Nested control files are not allowed. 

MAP386 returns to the command line when it encounters the end of a 
control file. 


Refer to Section 4.5 for the content and format of control files. 


Invocation Examples 
In all of the following examples, four control files are invoked in 
three different combinations. Control file CF1.DAT contains files 
and controls, as follows: 


FILE1.0B8J, FILE2.0BJ, FILE3.0BJ NOSS EP *) 
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CONTROLFILE (continued) 
Control file CF2.DAT contains files only: 


FILE4.OBJ, FILES.OBJ, FILE6.OBJ 
Control file CF3.DAT contains controls only: 
NOSS PR (A1.MAP) TT ("THIS IS A TITLE") 


Control file CF4.DAT contains files only, but with a comma after the 
last file name: 


FILE7.OBJ, FILE8.0BJ, FILE9.OBJ, 


Examples 


DOS: 


VMS: 


DOS: 


VMS: 


DOS: 


VMS: 


1. In the following examples, the PAGEWIDTH and NOXREF controls 
and the A.OBJ input file are specified on the command line with 
CF4.DAT and CF2.DAT. 


MAP386 A.OBJ, CF (CF4.DAT) CF (CF2.DAT) PAGEWIDTH (90) NOXREF 


MAP386/PAGEWIDTH = 90/NOXREF/CF = CF4.DAT A.OBJ "CF(CF2.DAT)" 


2. In the following examples, the PAGEWIDTH and NOXREF controls 
and the B.OBJ input file are specified on the command line with 
CF4.DAT and CF1.DAT; 

MAP386 B.OBJ, CF (CF4.DAT) CF (CF1.DAT) PAGEWIDTH (90) NOXREF 


MAP386/PAGEWIDTH = 90/NOXREF/CF = CF4.DAT B.OBJ" CF (CF1.DAT)" 


3. In the following examples, all input files and controls except 
C.OBJ are specified in the control files CF2.DAT and CF3.DAT. 


MAP386 C.OBJ, CF (CF2.DAT,CF3.DAT) 


MAP386 "CF (CF2.DAT,CF3.DAT)" C.OBJ 
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ERRORPRINT/NOERRORPRINT 


Creates or suppresses creation 
of error print file 


Syntax re) 


DOS: ERRORPRINT [(filename) ] 
NOERRORPRINT 

VMS: /ERRORPRINT [= filename] 
/NOERRORPRINT 


Abbreviations 


EP, NOEP 


Default 


NOERRORPRINT oO 


Description 


The ERRORPRINT control directs all error messages, including 
warnings, errors, and fatal errors, to one of the following: 


e the console, if no file name is specified 


e The error print file specified by filename 


The NOERRORPRINT control prevents nonfatal errors and warnings 
from being sent to the error print file. 


When the file name is the same as the name of an input file, control 
file, or output file, processing aborts. 


* 
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ERRORPRINT/NOERRORPRINT (continued) 


Whether ERRORPRINT is in effect or not, fatal error messages are 
displayed at the console and all error and warning messages are 
included in the print file. The number of error and warning messages 
is reported in the sign-off message. 


Examples 


DOS: 


VMS: 


DOS: 


VMS: 


1. In the following examples, MAP386 sends all error messages and 
warnings to the error print file MOD2.LIS. MODI1.OBJ is the 
input file. 

MAP386 MOD1.OBJ ERRORPRINT (MOD2.LIS) 


MAP386/ERRORPRINT = MOD2.LIS MOD1.0BJ 


2. In the following examples, MAP386 sends all error messages and 
warnings to the console by default. 


MAP386 MOD1.0BJ ERRORPRINT 


MAP386/ERRORPRINT MOD1.0BJ 
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OBJECT/NOOBJECT 


Creates output object file from 
loadable or bootloadable input files 


Syntax @) 


DOS: OBJECT [(filename) ] 
NOOBJECT 

VMS: /OBJECT [= filename] 
/NOOBJECT 


Abbreviations 


OJ, NOOJ 


Default 


When OBJECTCONTROLS or OSINFO is specified: OBJECT (input- 
filename.OUT). When neither OBJECTCONTROLS nor OSINFO is 
specified: NOOBJECT O 


Description 


The OBJECT control produces an output object file from a loadable 
input file. MAP386 copies all sections of the input file to the output 
file, except when OBJECTCONTROLS directs MAP386 to remove debug 
information. Refer to the description of OBJECTCONTROLS for more 
information. 


When only the output object file is required, specify NOPRINT; this 
suppresses the print file and saves execution time and space. 
Otherwise, a print file is created as well. 


The NOOBJECT control suppresses creation of a loadable output 


module. oO 
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OBJECT/NOOBJECT (continued) 


Examples 


DOS: 


VMS: 


DOS: 


VMS: 


1. In the following examples, MAP386 generates an output object 
file named MOD2.DAT. By default, MAP386 also creates a print 
file. MOD1.OBJ is the input file name. 


MAP386 MOD1.0BJ OBJECT (MOD2.DAT) 


MAP386/OBJECT = MOD2.DAT MOD1.0BJ 

2. In the following examples, MOD3.OBJ is the input file name. 
Because no output file name is specified, MAP386 generates an 
output object file named MOD3.OUT. 

MAP386 MOD3.0BJ OBJECT 


MAP386/OBJECT MOD3.0BJ 


Using the 80386 Mapper 4-27 


OBJECTCONTROL 


Includes or removes debug information 
in output object file 


Syntax  #] 


DOS: OBJECTCONTROLS (objetrl [ [EXCEPT] 
(mod-name[,...])][,...]) 


VMS: /OBJECTCONTROLS = ("“objctr1[ [EXCEPT] 
(mod-name[,...])]"{[,...]) 

Where: 

objetl Is one of the following: 
Object Control Abbreviation 
DEBUG DB 
NODEBUG NODB 
EXTERNALS ET 
NOEXTERNALS NOET oO 
LINES LI 
NOLINES NOLI 
PUBLICS Ply 
NOPUBLICS NOPL 
SRCLINES SL 
NOSRCLINES NOSL 
SYMBOLS SB 
NOSYMBOLS NOSB 

mod-name is the name of a separately translated module 


that has been input to BND386 or to the 
BLD386 System Builder to create the loadable 
file named in the invocation line. 


Abbreviations oO 


oc [EC] 
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OBJECTCONTROL (continued) 
Default 


DOS, OBJECTCONTROLS (DB), or VMS, OBJECTCONTROLS = (DB). 
All debug information is retained. 


Description 


The OBJECTCONTROLS control removes specified debug information 
from a loadable input file. MAP386 creates an output object file that 
is just like the input file, except that the specified debug information 
is omitted. OBJECTCONTROLS has no tables or tasks controls. 


The DEBUG, EXTERNALS, LINES, PUBLICS, SRCLINES, and SYMBOLS 
object controls direct MAP386 to retain various kinds of debug 
information; the NODEBUG, NOEXTERNALS, NOLINES, NOPUBLICS, 
NOSRCLINES, and NOSYMBOLS object controls direct MAP386 to 
remove certain information. Object controls may be specified in any 
order. When invoking MAP386 to purge debug information, also 
specify NOPRINT to save time and memory. 


DEBUG includes all debug information in the output object file, 
including external symbol definitions, line number definitions, public 
symbol definitions, source line numbers, and symbol definitions. 
NODEBUG removes this information from the output object file. 


The construction EXCEPT mod-name [,...] excludes the listed 
modules from the effects of the preceding object control. 


EXTERNALS includes external symbol definitions in the output object 
file. NOEXTERNALS removes external symbol definitions from the 
output object file. 


LINES includes line number definitions in the output object file. 
NOLINES removes line number definitions from the output object file. 


PUBLICS includes public symbol definitions in the output object file. 
NOPUBLICS removes public symbol definitions from the output object 
file. 


SRCLINES includes source line numbers in the output object module. 
NOSRCLINES omits source line numbers from the output object 
module. 
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OBJECTCONTROL (continued) 


SYMBOLS includes local symbol definitions in the output object file. 
NOSYMBOLS removes local symbol! definitions from the output object 
file. 


You can select which debug information is to be retained or removed we) 
by specifying the module name or list of module names plus the 

desired object control. Only the information previously contained in 

the module is affected. 


You can exclude selected modules from the effect of the object 
control. Specify EXCEPT plus the module name or list of module 
names. 


If you specify an object control without any module names, the 
control affects all the debug information in the file. 


OBJECTCONTROLS has no effect if the modules input to MAP386 are 
linkable modules. 


Because an output object file is produced with OBJECTCONTROLS, it is 


not necessary to also specify the OBJECT control, except to direct the 
output to filename. Oo 


NOTE 


OBJECTCONTROLS is not effective when NOOBJECT is used, and 
no object file is produced. 


Examples 
1. In the following examples, MAP386 removes all debug 
information contained in the input file. The output file is 
MODI1.OUT. 
DOS: MAP386 MOD1.0BJ OBJECTCONTROLS (NODEBUG) 


VMS: MAP386/OBJECTCONTROLS = NODEBUG MOD1.0BJ oO 
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OBJECTCONTROL (continued) 


2. In the following examples, MAP386 removes line numbers, local 
symbol definitions originally contained in MOD3, and public 
symbols definitions originally contained in all modules except 
MOD2 and MOD3. 

© DOS:  MAP386 MOD2.0BJ OC (NOLI, NOSB(MO03), NOPL EC(MOD2,MOD3)) 


VMS: MAP386/0C = (NOLI,"NOSB(MOD3)","NOPL EC(MOD2,MOD3)")MOD2.OBJ 
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OSINFO 


Creates or updates operating system 
information section of object file 


Syntax © 


DOS: OSINFO (filename) 


VMS: /OSINFO = filename 


Abbreviation 


or 


Default 


The operating system information field in the object file is not 
created or updated. 


Description oO 


The OSINFO control creates or updates the operating system 
information field in the object file by copying the contents of the file 
name (including its path) into the OSINFO field in the object file. 
For a large file, only the first 4K bytes are written to OSINFO and a 
warning is issued. See documentation on your target operating system 
for more details. 


NOTE 


OSINFO is not effective when used with NOOBJECT. 
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OSINFO (continued) 
Examples 
In the following examples, operating system information for the file 
MODI1.OBJ is copied into the osinfo field in the object file. 
MOD2.OB3J is the input file name. 
DOS: MAP386 MOD2.0BJ OSINFO (MOD1.0BJ) 


VMS: MAP386/0SINFO = MOD1.0BJ MOD2.0BJ 
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PAGELENGTH 


Sets lines per page 
for output listing 


Syntax 
DOS: PAGELENGTH (length) 
VMS: /PAGELENGTH = length 


Abbreviation 


PL 


Default 


A page is 60 lines long. 


Description 


The PAGELENGTH control specifies the number of lines per page in 
MAP386 output listings (e.g., print and cross-reference files). 
Headings are included in the lines per page specification. Page length 
may be set to from 10 to 65535 lines. 


NOTE 


PAGELENGTH is not effective when used with NOPAGING. 
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* 


PAGELENGTH (continued) 


Examples 
1. In the following examples, the page length in output listings is set 
to 120 lines per page. 


DOS: MAP386 MOD1.0BJ PAGELENGTH (120) 


VMS: MAP386/PAGELENGTH = 120 MOD1.0BJ 
2. In the following example, the page length in output listings is set 
to 60 lines per page by default. 


DOS or VMS: MAP386 MOD1.OBJ 
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PAGEWIDTH 


Sets characters per line 
for output listing 


Syntax oO 


DOS: PAGEWIDTH (width) 


VMS: /PAGEWIDTH = width 


Abbreviation 


PW 


Default 


A page is 120 characters wide. 


Description oO 


The PAGEWIDTH control specifies the maximum number of characters 
per line in MAP386 output listings (e.g., print and cross-reference 
file). Page width may be set to from 80 to 132 characters per line. 
(The system will accept widths from 72 to 80 as well, but these 
settings are not recommended, due to the width of the map.) If the 
number of characters in a line exceeds the physical width of the page, 
the extra characters wrap to the following line. 


NOTE 


PAGEWIDTH is not effective when used with NOPAGING. 
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PAGEWIDTH (continued) 


Examples 
1. In the following examples, the line width in output listings is set 
to 100 characters. 


DOS: MAP386 MOD1.0BJ PAGEWIDTH (100) 


VMS: MAP386/PAGEWIDTH = 100 MOD1.0BU 


2. In the following example, the line width in output listings is set 
to 120 characters by default. 


DOS or VMS: MAP386 MOD1.0BJ 
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PAGING/NOPAGING 


Creates page breaks 
in print file 


Syntax ] 


DOS: PAGING 
NOPAGING 


VMS: /PAGING 
/NOPAGING 


Abbreviations 


PG, NOPG 


Default 


PAGING 


Oo 


Description 


The PAGING control prints the output map with page breaks. Each 
output page contains the number of lines specified by the 
PAGELENGTH control (with default at 60 lines). Each new output page 
has a heading containing the label "80386 MAPPER", a title (specified 
with the TITLE control), the date, and a page number. 


NOPAGING prints the output file printed continuously and the heading 
appears on the first page only. 


With NOPAGING, PAGELENGTH and PAGEWIDTH are not in effect, and 
page length and width are unspecified. 


*) 
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PAGING/NOPAGING (continued) 


Examples 


DOS: 


VMS: 


DOS: 


VMS: 


1. In the following examples, MAP386 produces a print file with 
pages that are 55 lines long. A heading appears at the top of 
each page. 


MAP386 MOD1.0BJ PAGELENGTH (55) 


MAP386/PAGELENGTH = 55 MO01.0BJ 


2. In the following examples, MAP386 produces a print file that is 
not separated by page breaks. MOD2.OBJ and MOD3.OBJ are 
input files. 

MAP386 MOD2.0BU, MO03.0BJ NOPAGING XREF (MOD1.LIS) 


MAP386/NOPAGING/XREF = MOD1.LIS MOD2.0BJ, MOD3.OBJ 
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PRINT/NOPRINT 


Creates or suppresses 
creation of print file 


Syntax  # 


DOS: PRINT [ (filename) ] 
NOPRINT 

VMS: /PRINT [= filename] 
/NOPRINT 


Abbreviations 


PR, NOPR 


Default 


PRINT (first-input-filename.MAP) Oo 


Description 


The PRINT control creates a print file, which contains the Module List 
and output maps, including the Table Map, Segment Map, Gate Map, 
Symbol Map, Public Map, Task Map, and error messages. The 
Cross-Reference Map is included in the print file if directed there 
with the XREF control. You can also use XREF to create a separate 
cross-reference file for the cross-reference map. If XREF and the file 
name for the cross-reference file are specified, the cross-reference 
map is placed in that file rather than the print file. 


The print file begins with a heading containing the label "80386 


MAPPER," a title (specified with the TITLE control), the date, and 
page number. The file also includes error and warning messages. 


*) 
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PRINT/NOPRINT (continued) 


When filename is specified, MAP386 assigns that name to the print 
file. Otherwise, by default, if the PRINT control is not specified or if 
PRINT is specified without a file name, the name of the print file is 
the same as input-filename, with extension .MAP. The contents 
and format of the print file are described later in this chapter. 


The NOPRINT control suppresses creation of a print file. NOPRINT has 
no effect on the cross-reference map when the print file and 
cross-reference file are different. You can use NOPRINT to save time 
when purging debug information or adding the osinfo section. 


Use ERRORPRINT to create a separate error print file for error 
messages. Should a fatal error condition occur, the fatal error 
message is displayed on screen. 


NOTE 


If the default file name or a specified file name matches the 
name of the input file or any other output file, MAP386 
processing aborts. 


Examples 


1. In the following examples, the cross-reference map, error 
messages, and print file information (e.g., input and output 
identifiers, control list and modules processed) are directed to the 
print file MOD2.LIS. MOD1.OBJ is the input file. 


DOS:  MAP386 MOD1.0BJ PRINT (MOD2.LIS) 


VMS: \MAP386/PRINT = MOD2.LIS MOD1.0BU 


2. In the following example, MAP386 print file information and 
cross-reference map are sent to the default print file. 
MODI.MAP is the default print file. 


DOS or VMS: MAP386 MOD1.OBJ 
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PRINT/NOPRINT (continued) 


3. In the following examples, the file is written to the standard 
output device. 


DOS: MAP386 MOD.OBJ PRINT (:CO:) 


VMS: MAP386/PRINT = SYSSOUTPUT MOD.OBJ 
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PRINTCONTROLS 


Includes or omits selected 
maps from print file 


O Syntax 


DOS: PRINTCONTROLS (prtctrl [[EXCEPT] (mod-name 
[.-+-J)][,---]) 
VMS: /PRINTCONTROLS = ("prtctrl1 [[/EXCEPT] (mod-name 
[ices I [paw cd 

Where: 

prtctrl Is one of the following print controls: 
Print Control Abbreviation 
DEBUG DB 
NODEBUG NODB 
LINES LI 

ae) NOLINES NOLI 

PUBLICS 2L 
NOPUBLICS NOPL 
SRCLINES SL 
NOSRCLINES NOSL 
SYMBOLS SB 
NOSYMBOLS NOSB 
TABLES TB 
NOTABLES NOTB 
TASKS TA 
NOTASKS NOTA 

mod -name is the name of a separately translated module 


that has been input to BND386 or to the 
BLD386 System Builder to create the loadable 
oO file named in the invocation line. 
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PRINTCONTROLS (continued) 
Abbreviation 


Default 


PC 


PRINTCONTROLS (DEBUG, TABLES, TASKS) 


Description 


4-44 


The PRINTCONTROLS control modifies the contents of the print file. 
(It does not affect the contents of the cross-reference map.) Specified 
print controls include or omit specified maps from the print file. The 
print controls DEBUG, LINES, PUBLICS, SRCLINES, SYMBOLS, TABLES, 
and TASKS cause certain maps to be included. Specify a module name 
or list of module names after a print control to print maps describing 
only the information originally contained in that module or modules. 
If you do not specify a module name, the print controls affect the 
contents of the entire file, regardless of the linkable module from 
which the information originated. The controls NODEBUG, NOLINES, 
NOPUBLICS, NOSRCLINES, NOSYMBOLS, NOTABLES, and NOTASKS cause we) 
certain maps to be omitted. Print controls can be specified in any 
order. 


You can exclude a module or modules from the effect of a print 
contro] with EXCEPT, by specifying a print control followed by the 
EXCEPT control followed by a module name or list of module names. 
The information previously contained in the module or modules is 
excluded from the effect of the print control. For example, 
PRINTCONTROLS can be specified in the invocation line as follows: 


PRINTCONTROLS (NOPAGELENGTH EXCEPT(MOD1, MOD3)) 


In this case, the public map would include public symbol information 
for symbols originally declared in modules MODI and MOD3. 


You cannot limit TASKS, NOTASKS, TABLES, and NOTABLES by *) 
specifying a module name; all modules will be affected by the 
specified print control. 


DEBUG includes a symbol map and public map in the print file. 
NODEBUG omits the symbol map and public map from the print file. 


Using the 80386 Mapper 


PRINTCONTROLS (continued) 


LINES includes a section in the symbol map that contains line number 
definitions and their logical addresses. NOLINES omits this section. 


PUBLICS includes a public map in the print file. NOPUBLICS omits 


0 the public map. 


SRCLINES includes a section in the print file that contains source line 
definitions. NOSRCLINES omits this section. 


SYMBOLS includes a section in the symbol map that lists symbols and 
their types and addresses. NOSYMBOLS omits this section. 


TABLES includes a table map, gate map, and segment map in the print 
file. NOTABLES omits these maps. You cannot specify mod-names for 
TABLES or for NOTABLES. 


TASKS includes a task map in the print file. NOTASKS omits the task 
map. You cannot specify module names for TASKS or NOTASKS. 


NOTES 
i) PRINTCONTROLS is not effective when used with NOPRINT. 


SYMBOLS, NOSYMBOLS, LINES and NOLINES are not effective 
when used with NODEBUG. 


Any input file specified on the MAP386 invocation line must 
be loadable. 


Examples 


In the following examples, MOD1.OBJ is a loadable input file. A 
print file is created and contains the following: 


e Module list 
e Public map for all original input modules except MOD5 and 


oO MOD6 
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PRINTCONTROLS (continued) 


e Symbol map for all original input modules except MODS and 
MOD6, which will, however, include lines. The symbol map 
describes local symbols for all original modules, and contains 
source line numbers and addresses for all original modules except 
MOD3. 


e Table map, gate map, and segment map for all modules. The task 
map is not be printed. 


DOS: MAP386 MOD1.0BJ PC (DB EC(MOD5,MOD6), LI EC(MOD3), NOTA) 


VMS: MAP386/PC = ("DB EC (MOD5,MOD6)","LI EC(MOD3)",NOTA) MOD1.OBJ 
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SYMBOLSORT/NOSYMBOLSORT 


Prints symbol names in alphabetical 
order or in order of occurrence 


oO Syntax 


DOS: SYMBOLSORT 
NOSYMBOLSORT 

VMS: /SYMBOLSORT 
/NOSYMBOLSORT 


Abbreviations 


Ss, NOSS 


Default 


Oo SYMBOLSORT 


Description 


The SYMBOLSORT control prints lists of symbol names in alphabetical 
order in output maps. 


NOSYMBOLSORT prints symbol names in the order in which they occur 
in the input object file. This preserves scoping information. 


Examples 


” In the following examples, symbol names appear in the symbol map 
and cross-reference map in alphabetical order. 


DOS: MAP386 MOD1.0BJ SYMBOLSORT 


oO VMS: MAP386/SYMBOLSORT MO01.0BJ 
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TITLE 


Places header line at top 
of each print file page 


Syntax oO 


DOs: TITLE (title) 


VMS: /TITLE = "title" 


Abbreviation 


TT 


Default 


TITLE is not in effect and the title string is left blank. 


Description re) 


The TITLE control specifies the page title of the page heading. The 
title must be an alphanumeric string of 80 characters or less. When 
you use spaces or other delimiters in the title, you must enclose the 
whole title in apostrophes (’). 


The title is truncated on the right when the specified page width does 
not allow enough room for the complete title. 


If the cross-reference map and the print file are separate files, the 
same title appears in the headings of both files. 


4-48 Using the 80386 Mapper 


TITLE (continued) 


Examples 


DOS: 


VMS: 


DOS: 


VMS: 


1. In the following examples, when the file is printed, the title that 
appears at the top of each page is CROSS-REF MAP FOR PL/M 
PROG XYZ. 


MAP386 MOD1.OBJ TITLE ('CROSS-REF MAP FOR PL/M PROG XYZ') 


MAP386/TITLE = "CROSS-REF MAP FOR PL/M PROG XYZ" MOD1.0BJ 


2. In the following examples, when the file is printed, the title 
CROSS-REF MAP appears at the top of each page. A cross- 
reference map is generated and sent to the cross-reference file 
MOD2.LIS. MODI1.OBJ is the input file and MOD1.MAP is the 
print file. 


MAP386 MOD1.OBJ TITLE ('CROSS-REF MAP') XREF (MO02.LIS) 


MAP386/TITLE = "CROSS-REF MAP"/XREF = MOD2.LIS MOD1.0BJ 
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TYPE/NOTYPE 


Ignores types 
Syntax oO 
DOS: TYPE 
NOTYPE 
VMS: /TYPE 
/NOTYPE 


Abbreviations 


TY, NOTY 


Default 


TYPE 


Description ) 


The TYPE control specifies that type information be printed. NOTYPE 
suppresses the checking and printing of type information. 


NOTE 


TYPECHECK is not effective when used with NOTYPE. 


Examples 


In the following examples, NOTYPE is specified so that type 
information is neither checked nor printed. 


DOS: MAP386 MOD.OBJ NOTYPE *) 


VMS: MAP386/NOTYPE MOD.OBJ 
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TYPECHECK/NOTYPECHECK 


Enables or suppresses 


type checking 
Syntax 
DOS: TYPECHECK 
NOTYPECHECK 
VMS: /TYPECHECK 
/NOTYPECHECK 


Abbreviations 


Tc, NOTC 


Default 


TYPECHECK 


Description 


The TYPECHECK control performs type checking between public and 
external symbols of the same name in the input file. If a mismatch is 
found, MAP386 issues a warning message. Type mismatches are 
detected even if the BND386 or BLD386 NOTYPE control has been 
used to purge type information from the input file. This type 
checking is less comprehensive than the type checking performed by 
BND386. 


NOTYPECHECK suppresses type checking, and the error file will not 
notify you of mismatches between public and external symbol types 


TYPECHECK and NOTYPECHECK do not affect the information about 
public and external symbols in output maps. For example, the 
cross-reference map lists symbol types even when NOTYPECHECK is 
specified. 
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TYPECHECK/NOTYPECHECK (continued) 
Examples 


In the following examples, type checking is suppressed; MAP386 does 

not issue warnings about type mismatches. MOD2.LIS is the print 

file; MOD1.OB) is the input file. oO 
DOS:  MAP386 MOD1.0BJ NOTYPECHECK PRINT (MO02.LIS) 


VMS: MAP386/NOTYPECHECK/PRINT = MOD2.LIS MOD1.0BJ 
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TYPECHECK/NOTYPECHECK 


Enables or suppresses 


type checking 
Syntax 
DOS: TYPECHECK 
NOTYPECHECK 
VMS: /TYPECHECK 
/NOTYPECHECK 


Abbreviations 


Tc, NOTC 


Default 


TYPECHECK 


Description 


The TYPECHECK control performs type checking between public and 
external symbols of the same name in the input file. If a mismatch is 
found, MAP386 issues a warning message. Type mismatches are 
detected even if the BND386 or BLD386 NOTYPE control has been 
used to purge type information from the input file. This type 
checking is less comprehensive than the type checking performed by 
BND386. 


NOTYPECHECK suppresses type checking, and the error file will not 
notify you of mismatches between public and external symbol types 


TYPECHECK and NOTYPECHECK do not affect the information about 
public and external symbols in output maps. For example, the 
cross-reference map lists symbol types even when NOTYPECHECK is 
specified. 
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TYPECHECK/NOTYPECHECK (continued) 
Examples 

In the following examples, type checking is suppressed; MAP386 does 

not issue warnings about type mismatches. MOD2.LIS is the print 

file; MOD1.OBJ is the input file. oO 
DOS: MAP386 MOD1.0BJ NOTYPECHECK PRINT (MOD2.LIS) 


VMS: MAP386/NOTYPECHECK/PRINT = MOD2.LIS MOD1.OBJ 
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XREF/NOXREF 
Directs intermodule cross-reference map between 
public and external symbols to specified file 


Syntax 

DOS: XREF [ (filename) ] 
NOXREF 

VMS: /XREF [= filename) ] 
/NOXREF 


Abbreviations 


XR, NOXR 


Default 


XREF and the cross-reference map file have the same name as the 
print file. 


Description 
The XREF control generates an intermodule cross-reference map 
between public and external symbols. When a file name is specified, 
the map is sent to that file. Otherwise, the map is sent to the print 
file. 


NOXREF suppresses the generation of cross-reference maps. 


NOTE 


The cross-reference map is not printed when XREF is used with 
NOPRINT. 
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XREF/NOXREF (continued) 
Examples 


1. In the following examples, the cross-reference map is generated 
and sent to the XREF file MOD2.LIS. Other maps and print file 
information are sent to the default print file, MOD1.MAP. 


DOS: 


VMS: 


DOS: 


VMS: 
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MAP386 MOD1.OBJ XREF (MOD2.LIS) 


MAP386/XREF = MOD2.LIS MOD1.0BJ 


2. In the following examples, the generation of cross-reference maps 
is suppressed and the remaining print file information is directed 
to MOD2.MAP. MODI.OBJ is the input file. 


MAP386 MOD1.OBJ NOXREF PRINT (MOD2.MAP) 


MAP386/NOXREF/PRINT = MOD2.MAP MOD1.OBJ 
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4.9 


MAP386 Print Files 


MAP386 produces maps each time it is invoked, unless the NOPRINT 
control is specified. MAP386 places the cross-reference map in the 
file specified by the XREF control or, by default, in the file implied 
by the PRINT control. 


When the input file is linkable, MAP386 produces only one print file 
containing a module list and the cross-reference map. When the input 
file is loadable, MAP386 can create any of the following maps: table 
map, segment map, gate map, task map, symbol map, public map, and 
cross-reference map. 


All maps except the cross-reference map appear in the print file, 
whose file name is specified with the PRINT control. When PRINT 
does not provide a file name, MAP386 by default gives the print file 
the same file name as the input file, with extension .MAP. The 
cross-reference map can be included in the print file, but it can also 
be directed to another file with the XREF control. 


The print file can contain the following sections, in this order: 


Header 

Module list 
Table map 
Segment map 
Gate map 
Symbol map 
Public map 
Task map 
Cross-reference 
Error messages 


The cross-reference map can be directed to another file or excluded 
altogether with NOXREF. Error messages can be directed to another 
file with ERRORPRINT and also appear in the print file. Selected maps 
(table, segment, gate, symbol, public, or task) can be excluded from 
the print file by the use of print controls. 
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The following sections describe and give format examples of each part 
of the print file. In the examples, Xs indicate the space allotted to an 
entry; they are replaced by names or numbers in actual print files. 
Minuses are printed in the field if the absolute value has not yet been 
defined. 


4.9.1 Header 
The print file header summarizes the MAP386 invocation 


specifications by listing input and output file names and controls 
specified. Figure 4-2 shows the format of the print file header. 


80386 MAPPER title date PAGE number 
system-id 80384 MAPPER. Vx-yVX 
INPUT FILE: filename [1 - + <] 


INPUT OSINFO FILES: filename 

OUTPUT OBJECT FILE: filename 

OUTPUT PRINT FILE: filename 

OUTPUT XREF FILE: filename 

CONTROLS SPECIFIED: controll. controle 


fear ese sees = (warnings, if any. appear here) 


Figure 4-2 MAP386 Print File Header 


4.9.2 Module List 


The module list names the input files and the modules contained in 
each file. Files are listed in the order in which they appear in the 
input list. MAP386 prints a question mark (7) to the left of the 
names of modules containing no debug information. Figure 4-3 
shows the format of the module list. 
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oO 


MODULES INCLUDED: 


FILE NAME MODULE NAME(S) 

XXXXXXXXX XXXXXXXXXXXXXX XXX XXX XXX XXX K 
XXXXXXXXKXXXXX XXXXXXXXXKXXXX 

XXXXXXXXKX XXXXXXXXXKXXXXX XXXXXXXXXXXXXX 


4.9.3 


XXXXXXXXXXXXXK XXXXXXXXKXXXXXX 


m-0564 


Figure 4-3 MAP386 Module List 


Table Map 


The table map contains information about GDTs, IDTs, and LDTs. 
For each descriptor table in the input, the table map lists table 
indexes, selector values (except IDT) for table descriptors, and 
descriptor names. Table indexes appear in decimal notation in 
ascending numerical order. Selector values appear in hexadecimal 
notation. 


The table map lists information about the GDT first, information 
about the IDT second, and information about the LDT third. LDT 
descriptions include a decimal value labeled SEQ. NO.; this value is 
the sequence number of the LDT in the GDT. MAP386 lists only 
indexes that have valid descriptor entries. Figure 4-4 shows the 
format of the table map. 
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DESCRIPTOR TABLE MAP 


TABLE = GDT 
TABLE INDEX 


XXXX 


XXXX 
TABLE = IDT 
TABLE INDEX 


XXXX 


XXXX 
TABLE = xxxxxxxxx 
TABLE INDEX 


XXXKX 


XXXX 


BASE = xxxxxxxxH 
SELECTOR 


XxXxxH 


XXxXH 
BASE = xxxxxxxxH 
DESCRIPTOR NAME 


XXXXXXXXXXXX 


XXKXXXXXKKXKXXK 
SE@. NO. Fn 
SELECTOR 


xxxxH 


XxXXXH 


BASE xxxxxxxxH 


LIMIT = xxxxH 
DESCRIPTOR NAME 
XXXXXRXKXXKX 


XXXXXXXXXXXX 


LIMIT = xxxxH 


DESCRIPTOR NAME 
XXXXXXXXXXXX 


XXXXXXXXXKXXX 


Figure 4-4 MAP386 Table Map 


LIMIT 


XXXxXH 
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4.9.4 


4.9.5 


Segment Map 


The segment map lists each input segment alphabetically and 
according to descriptor table. For each segment, the map includes the 
segment name, its index (slot number) in the descriptor table, present 
bit (PBIT), descriptor privilege level (DPL), USE16/32 attribute, align 
attribute, access type, base or relocation information (an eight-digit 
hexadecimal number), limit of the page-fixed part (an eight-digit 
hexadecimal number for USE32 or a four-digit hexadecimal number 
for USE16), limit (an eight-digit hexadecimal number for USE32 or 
four-digit hexadecimal number for USE16). If the map does not fit 
on one line, the SEGMENT name will be printed on a separate line. 
Access types (listed under the heading ACCESS) are denoted as 
follows: 


EO Executable only 

ER Executable and readable 
Cc Conforming 

RO Read only 

RW _ Readable and writable 
D Expand-down 


For example, ERC indicates that a segment is loadable, readable, and 
conforming. RWD indicates that a segment is readable, writable, and 
expand-down. Figure 4-5 shows the format of the segment map. 


Gate Map 


The Gate Map lists each gate alphabetically and according to 
descriptor table. For each gate, the map contains the gate’s name, 
descriptor table name, index (slot number) in the descriptor table, 
present bit (PBIT), descriptor privilege level (DPL), type of gate, 
word count (WC), selector of the gate entry point, and offset of the 
gate entry point. Gate types are listed as 286CALL, 386CALL, 
286INTR (for interrupt), 386INTR, 286TRAP, 386TRAP, or TASK. 
Figure 4-6 shows the format of the gate map. 
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SEGMENT MAP 


TABLE = xxxxxxxx 


SEGMENT NAME TABLE INDEX PBIT USE ODPL ALIGN ACCESS 


XXXXXXXX XXXX x XXXXX x XXXX 


XXXXXXXX XXXX x XXXXX KX = XXXX 


TABLE & xxxxxxxx 


SEGMENT NAME TABLE INDEX PBIT USE ODPL ALIGN ACCESS 


XXXXXXXX XXXX x XXXXX x XXXX 


XXXXXXXX XXXX x XXXXX x XXXX 


** Elther BASE or RELOCATION will be printed depending on the BND386 control. 


XXX 


XXX 


XXX 


XXX 


** 


XXXXXXXXH 


XXXXXXXXH 


** 


XXXXXXXXH 


XXXXXXXXH 


Figure 4-5 MAP386 Segment Map 
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LIMIT 


XXXXXXXH 


XXXXXXXH 


LIMIT 


XXXXXXXH 


XXXXXXXH 
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*) 


GATE MAP 


TABLE? xxxxxxxxx 
oO GATE NAME TABLE INDEX PBIT DPL TYPE WC SELECTOR OFFSET 
XXXXXXKXXXXKKXK XXXX x x XXXXXXX XxX GDTCxXxxx)  xxxxxxxxH 
XXXXXXXXXXXXX XXXX x x XXXXXXX XxX GDTCxxxx)  xxxxxXxXXxXH 
XXXXXXXXXXXKK XXXX x x XXXXXXX XX LDTCxxxx)  xxxxxxXxXH 
XXXXXXXXXXXXX XXXX x x XXXXXXX XX GDTCxxxx)  xxxxxxxxH 
TABLE? xxxxXxxXxxx 
GATE NANE TABLE INDEX PBIT DPL TYPE WC SELECTOR OFFSET 
XXXXXXXXXXXXX XXXX x x XXXXXXX XX GDTCXxxx) = xxxxxxxxH 
XXXXXXXXXXXXXK XXXX x x XXXXXXX XX GDTCxxxx)  xxxxxXxxxH 
XXXXXXXXXXXXX XXXX x x XXXXXXX XX LDTCXxxx) = xxxxxxxxH 
XXXXXXXXXXXXX XXXX x x XXXXXXX XX GDTCxxxx)  xxxxXxxxXH 
m-0567 
i) Figure 4-6 MAP386 Gate Map 
4.9.6 Symbol Map 


The symbol map, which MAP386 produces on a per-module basis, 
consists of three sections: the first section describes local symbols; the 
second section describes line numbers and their offsets in the object 
code; the third section describes line numbers and their offsets in the 
source code. 


The first section of the symbol map lists the name of each local 
symbol, its logical address (given by values in the columns labeled 
BASE and OFFSET), and its type (such as word, byte, selector, pointer, 
procedure, etc.). If no type has been assigned to the symbol, the 
word NULL appears in the column labeled TYPE. The symbol map 
includes absolute addresses if they have been assigned to listed 
symbols by BLD386. Symbols are listed by name (under the SYMBOL 
NAME column) in the order in which they occur in the input module. 
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If a module contains a GDT, the first section of the symbol map 
indicates the GDT slot (index) that points to the module’s LDT. 


The symbol map indicates the logical address of each symbol, in the 

columns labeled BASE and OFFSET. The BASE column lists the symbol oO 
base, which represents the selector of the symbol, in terms of the 

symbol’s descriptor table and the table slot (index) within that 

descriptor table. The OFFSET column lists the offset in the segment 

indicated by the selector. Together the offset and selector form the 

logical address of the symbol. 


If the offset of the symbol is relative to the current stack, SS:EBP is 
printed in the BASE column. 


The symbol map indicates when a symbol is a based symbol, that is, a 
symbol whose logical address is determined by a value residing at the 
address of another symbol. For example, PL/M based variables are 
based symbols. 


Depending on the declarations made in the source program, the 
contents of the symbol’s base can be any of the following: O 


e The value of the selector portion of the symbol’s address. The 
symbol is-referred to as a selector-based symbol. 


e The value of the offset portion of the symbol’s address. The 
symbol is referred to as an offset-based symbol. 


e The value of both the selector and the offset of the symbol’s 
address. The symbol is referred to as a pointer-based symbol. 


The symbol map indicates that a symbol is based by displaying one of 
the following characters to the right of the hexadecimal value in the 
OFFSET column: 


P_ Indicates a pointer-based symbol; the symbol’s full logical address 
(composed of a selector and offset) is the value found at run time 
at the location given by the BASE and the OFFSET listings. 


address is the selector contained at location listed in the BASE 
column; the offset of the symbol’s logical address is given by the 
value found at run time at the location given by BASE and 
OFFSET listings. 


OQ Indicates an offset-based symbol; the base of the symbol’s logical O 
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S Indicates a selector-based symbol; the value found at run time at 
the location given by the BASE and OFFSET listings contains the 
selector of the symbol. The symbol’s implicit offset is zero. 


If a module has symbols from more than one LDT, the absolute 
addresses for the symbols are unknown and are marked with a 
question mark (?). The absolute address of symbols that refer to the 
IDT or constant symbols are also unknown. 


The absolute address of a symbol that refers to an unknown entry in 
the LDT or GDT is marked ** ERROR **, An undefined absolute 
address from a loadable file created by the BLD386 System Builder 
that has no base value is marked "-------- ". The absolute address of 
a gate symbol (the gate selector entry in the GDT or IDT) is the 
address of the gate entry. 


The second section of the symbol map lists lines of loadable source 
code and their offsets within code segments. The column labeled 
LINE lists line numbers (in multiples of five) corresponding to the 
line or statement numbers of the original source program. Under the 
heading OFFSET, MAP386 prints the offset portions of the logical 
addresses of the of loadable code that corresponds to each original 
source line (or source statement, depending on the compiler or 
assembler). Note that for highly optimizing compilers this 
information can be misleading. The logical address of each line is the 
code segment (given at the top of this section of the symbol map as a 
descriptor table name and index) plus the offset. Line numbers to 
which the offsets correspond ascend from left to right, beginning with 
the line listed in the LINE column. 


The third section of the symbol map lists source lines and their offset 
to the source file. The column labeled LINE gives line numbers in 
multiples of five that correspond to the source line. The column 
labeled OFFSET prints the offset portions of the logical addresses 
containing each source line. Line numbers to which the offsets 
correspond ascend from left to right, beginning with the line listed in 
the LINE column. Figure 4-7 shows the format of the symbol map. 
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SYMBOL MAP 


MODULE = xxxxxxxxx [. LDT = "GDTCindex)™] 

SYMBOL NAME BASE OFFSET TYPE ABSOLUTE ADDRESS 
XXXXXXXXXX LDT(xxxx) XXXXXXXXH XXXXX XXXXXXXxXH 
XXXXXXXXXX CUR. STACK xxxxxxxxH XXXXX XXXXXXXXH 
XXXXXXXXXX GDT(xxxx) XXXXXXXXH XXXXX XXXXXXXXH 
MODULE = xxxxxxxxxx CODE SEGMENT = "table(index)" 


LINE OFFSET IN CODE SEGMENT 


XXXX XXXXXXXKXH XXXXXXKKH XXXXXXXKH XXKXXXXKH XXXKKKKKH 
XXXX XXXXXXXKXH XXXXXXXKH XXXXXXXKH XXXKXXXKXH XXXXXXXXH 
XXXX XXXXXXXKH XXXKXXXXKH XXXXXXXXH 

XXXX XXXXXXXXH XXXXXXXKH XXXXXXXXH XXXXKXXXH 
XXXX XXXXXXXXH XXXXXXXXH XXXXXXXXH 


MODULE = xxxxxxxxx 
SOURCE PATHNAMNE = xxxxxxxxxxxxxxx 


LINE OFFSET IN SOURCE FILE 


XXXX XXXXXXXKH XXXXXXXXH XXXXXXXXH XXXXXXXKA XXXXXKXXH 
XXXX XXXXXXXKXH XXXXXXKKH XXKKKKKKA XXXKXKKKH XXXXKXXXXA 
XXXX XXXXXXXXH XXXXXXXKH XXXXXXXXH 

XXXX XXXXXXXKH XXXXXXXKH XXXXXXXKH XXXXXXXXH 
XXXX XXXXXXXXH XXXXXXXXH XXXXXXXXH 


Figure 4-7 MAP386 Symbol Map 
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oO 


oO 


4.9.7 


Public Map 


The public map alphabetically lists the name of each public symbol in 
input modules. For each public symbol, the map includes its symbol 
name, symbol type, word count (if applicable), and the logical 
address, including selector and offset. The absolute address if any, is 
displayed with the logical address. NULL in the type column 
indicates that the symbol type was not declared. 


Figure 4-8 shows the format of the public map. 


PUBLIC MAP 
MODULE = xxxxxxxxx 
PUBLIC NAME BASE OFFSET TYPE WC ABSOLUTE ADDRESS 
XXXXXXXXX LDTCxxxx) = xxxxxxxH XXXXX XK XXXXXXXXH 
XXXXXXXXK GDTCxxxx) = xxxxxxxH XXXXX XX XXXXXXXXH 
m-0574 
Figure 4-8 MAP386 Public Map 
4.9.8 Task Map 


For each task in an input module, the task map contains the initial 
stacks for all privileges, flags, initial CS and EIP values, the task’s 
LDT selector, initial segment register specifications, and the task’s 
page directory register. 


The task map lists tasks alphabetically. Figure 4-9 shows the format 
of the task map. 
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TASK MAP 


task name TSS 


GDT (index) DPL = number PBIT = x 


BASE = XXXXXXXXH 

LIMIT = XXXXXXXXH 

SSO:ESPO = "table (index) ™:xxxxxxxxH 
SS1:ESPL = "table (index)! xxxxxxxxH 
SS2:ESP2e = "table (index)™:xxxxxxxxH 
SS?ESP = "table (index) ™:xxxxxxxxH 
CS:EIP = "table (index) ™:xxxxxxxxH 
DS = "table (index)” 

FLAGS = XXXXXXXxXH 

LDTSEL = ldt_name AT GDT (index) 
PDR = XXXXXXXXH 

DEBUG TRAP NOT ENABLED 


m-0575 


Figure 4-9 MAP386 Task Map 


4.9.9 


Cross-Reference Map 


The cross-reference map can be included in the print file or directed 
to a separate file with the XREF control. If the NOPRINT control is 
specified and XREF is not specified with a different file name, the 
map is not printed. 


The cross-reference map lists the name of each symbol in the 
specified input module or modules, the type of each symbol, the name 
of the module containing the symbol’s public definition, and the 
names of any modules containing external references for the symbol. 


A warning is issued if a type mismatch occurs between two symbols. 
If a type mismatch occurs between a public definition and an external 
reference, the type used in the public definition is the symbol type 
listed in the cross-reference map. If a symbol has not been assigned a 
type, NULL appears in the type column. If the type is not defined in 
the public definition, the cross-reference map lists the type used in 
the external declaration. 
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Oo 


If the public definition of a symbol is not found in the input 
modules, MAP386 prints the following message in the column labeled 
DEFINING MODULES: 

*#kkX UNRESOLVED **** 


If a public symbol is defined more than once, MAP386 prints the 
following message: 


**k*kX DUPLICATE DECLARATION **** : mod-name. 


Figure 4-10 shows the format of the cross-reference map. 


CROSS REFERENCE MAP FOR: filename 
SYMBOL NAME TYPE DEFINING MODULE REFERRING MODULES 


XXXXXXXXXXXXXKXK XXXXXXXX XXXXXXXXX XXXXXXX XXXXX 
XXXXXX XXXXXX 


Figure 4-10 MAP386 Cross-Reference Map 


4.9.10 Warning and Error Messages 


The last item in the print file is the message PROCESSING COMPLETED and 
the number of error and warning messages generated during 
processing. See Appendix C for descriptions of MAP386 error and 
warning messages. 
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4.10 Descriptor Segment Naming 


If descriptors are unnamed, MAP386 assigns qualified names with a 
question mark (?) as the first character. The format of the qualified 
descriptor is as follows: oO 


2XXXX.N 
Where: 
XXXX is the descriptor type 
n is a sequence number assigned to the descriptor. 


Descriptor types can be one of the following: 


SEGMENT (code and data segments) 

LDT 

TASK 

286CALL_GATE 

386CALL_GATE 

TASK_GATE 

286INTR_GATE 

386INTR_GATE a) 
286TRAP_GATE 

386TRAP_GATE 


The sequence numbers start from one and increase in order of the 
segment’s occurrence in the object file. The LDT segments are an 
exception; their names are qualified as 7LDT.n where n is the 
sequence number assigned to the LDT in the table map. 
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4.11. Using MAP386: Examples 


The following examples show a sample MAP386 invocation and the 
resulting print file. 


#) DOS:  MAP386 TESTC2.386 PRINT (TEST.MAP) NOTYPECHECK& 
PAGEWIDTH (100) OSINFO (OSFILE)& 
OBJECTCONTROLS (NOLINES, NOSRCLINES) 


VMS: MAP386/PRINT = TEST.MAP/NOTYPECHECK- 
/PAGEWIDTH = 100/OSINFO = OSFILE- 
/OBJECTCONTROLS = (NOLINES, NOSRCLINES)- 
TESTC2.386 


MAP386 uses TESTC2.386 as input modules. The output consists of 
all maps, including a cross-reference map, and the maps are directed 
to the print file, TEST.MAP. Because the input file is linkable, 
MAP386 does not create an output object file. The default 
PAGELENGTH and PAGING controls are in effect. Page width is set to 
100 with the PAGEWIDTH control, resulting in printed pages 60 lines 
long and 100 columns wide, with headings, but no title, at the top of 

i) each page. The contents of the file OSFILE are included in the 
operating system information field of the output object file named 
TESTC2.OUT. The object controls specify that no line or source line 
information is included in the output file. No type checking is done. 
The name of the print file is TEST.MAP. 


Figure 4-11 shows the print file for DOS and Figure 4-12 shows the 
print file for VMS. 
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80386 MAPPER 
system-id 80386 MAPPER, Vx-yVX 


INPUT FILE(S): TESTC2.38b 
INPUT OSINFO FILE: OSFILE 
OUTPUT OBJECT FILE: TESTCe2- OUT 
OUTPUT PRINT FILE: TEST-MAP 
OUTPUT XREF FILE: TEST.MAP 


CONTROLS SPECIFIED: 
MODULES INCLUDED: 


PR(COST-MAP) NOTC PW(LOO) OSINFOCINFILE) OC(NOLI-NOSL) 


FILE NAME MODULE NAME(S) 

TESTC2.38b MAIN HELP mob2 ?DEBUG_INF 0 
DESCRIPTOR TABLE MAP 
TABLE = GDT BASE = ---~----- LIMIT = O02FH 
TABLE INDEX SELECTOR DESCRIPTOR NAME 

L o00BH CODE 

2 0013H PLMPROCL 

3 001BH PLNPROC2 

4 oo20H LDT? 

5 o028H TASK1 
TABLE = IDT BASE = --------- LIMIT = OOF7H 
TABLE INDEX DESCRIPTOR NANE 

Q TRAPGATE 
TABLE = LDT? SEQ. NO. = 1 BASE = --------- LIMIT = o027H 
TABLE INDEX SELECTOR DESCRIPTOR NAME 

1 ooocH LDT?: 

2 0017H CODE32 

3 OOLFH DATA 

4 0027H DATA 

Figure 4-11 Print File Example on DOS 
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SEGMENT MAP 


TABLE = GDT 
SEGMENT NAME TABLE INDEX PBIT USE DPL ALIGN ACCESS BASE LIMIT FIX 
CODE 1 1 -USE1L «3s WORD sOER o0003000H oO4BH oO 
TABLE = LDT? 
SEGMENT NANE TABLE INDEX PBIT USE DPL ALIGN ACCESS BASE LIMIT FIX 
CODE32 2 1 USE32 3 PARA ER QOO0L000H oo0000DAK coooO 
DATA 3 1 USE32_ «3 PARA RUD DOOOSOOOH FFFFFFFFH ooooo 
DATA 4 1 -USEZL «3 «=: WORD RUD FFFF4OL2H FFFDH Q 
LDT?: 1 1 USELb «O «=NONE «RU ~==------ an2?H a 
GATE MAP 
TABLE = GDT 
GATE NAME TABLE INDEX PBIT DPL TYPE UC SELECTOR OFFSET 
PLMPROCL 2 1 3 CALL28b 4S GD TCA) oo00H 
PLNPROC2 3 1 3 CALL28b 4 GDTC) ooogH 
TABLE = IDT 
GATE NAME TABLE INDEX PBIT DPL TYPE WC SELECTOR OFFSET 
TRAPGATE Q d 3 INTR38b --- LDT(2) 0000H 
SYMBOL MAP 
MODULE = MAIN, LTD = GDT (4) 
SYMBOL NANE BASE OFFSET TYPE ABSOLUTE ADDRESS 
As...» SSiEBP oo FFFFFFFEH INTEGER(2) 9 2 222 wewenenn= 
AB... « . ~ LDT(3) — FFFFFFEBH INTEGER(4) OOOO4FELH 
CFUNC . . « . LDT(2)  QUOOOOSBH C FUNCTION INTEGER(4) NEAR32  OD00205BH 
INL»... . SStEBP QO0000008H INTEGER(H)  wennenenn 
IN@.-.-, SS:EBP © OOQUDOOCH INTEGER) ween nae 
MAIN. » » . » LDT(2) © QODDOODOH C FUNCTION INTEGER(4) NEAR32  OO00L000H 
Figure 4-11 Print File Example on DOS (continued) 
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MODULE = 
LINE 
5 


10 
15 


MODULE = 


MAIN, CODE SEGMENT = LDT(2) 
OFFSET IN CODE SEGMENT 
ooooo000H 


oggoo019H goooddeFH 00000038H 
ogooo05BH oo00000SEH 


MAIN 


SOURCE FILENAME = MAIN-C 


ooo0000bH 
gooooo44H 
OooooObbH 


goo0003CH 
Oo000049DH 
o000010bH 


00000010H 
00000055H 
Oo00008H 


OOOO004BH 
OOOOOOBBH 
OOOOOLDEH 


OOOO4FFRH 


- LDT(2) OGODGOCBH C FUNCTION INTEGER(4) NEAR 32 OO0010CBH 
+ LDTC2) OOog0070H C FUNCTION INTEGER(4) NEAR 32 00001070H 


O0000007tH 
OOOO00B4H 
OOOODODbH 


LINE OFFSET IN SOURCE FILE 
5 ooo000e8R 00000033H 

10 QOOUOOSEH OO000078H O0000087H 

15 OOOOOUCSH QODOOOOESH OODODOEDH 
MODULE = HELP, LDT = GDT(4) 
SYMBOL NAME BASE OFFSET TYPE 
Ass + SS:EBP FFFFFFFEH INTEGER(2) 
ABC. - - LDT(3) FFFFFFFBH INTEGER(2) 
CFUNCL. - 
HELPFUNC. .- 
INL - - » SS?EBP OOOOO008H INTEGER(4) 
Ine - - « SS:EBP QOOO000CH INTEGER(4Y) 
MODULE = HELP, CODE SEGMENT = LDT(2) 
LINE OFFSET IN CODE SEGMENT 

§ o0000070H 

10 QO00000895H OO000005FH OO0000A8H 

15 oooo00CBH OOOo00CEH 
MODULE = HELP 


SOURCE FILENAME: HELP-C 


LINE 
5 


10 
15 
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OFFSET IN SOURCE FILE 


oooodo0eSH o0000038H 
QOOOO0L3H OOOODOD7EH OOOD008DH 
OOOO00CBH QOOO00EBH OO00000F3H 


go000041H 
OQO0000A3H 
O000010CH 


oo000080H 
aoo000CSH 
oo0000D8H 


ooo000S0k 
O00000C1H 
ooo00114H 


Figure 4-11 Print File Example on DOS (continued) 
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MODULE = MOD2, LDT = 


SYMBOL NAME BASE 
PLMPROC . - - GDT(1) 
VAL » « + « + SS?EBP 
MODULE = MOD2,. CODE S 
LINE OFFSET IN CO 
§ oo 
MODULE = ?DEBUG_INFO, 
SYMBOL NANE BASE 
Bes» « « « LDT(3) 
Ch aa es ey ce oe UDTCZ) 
PLMPROCL. - - GDT(2) 
PLMPROC2. . . GDT(3) 
TASKL - - + + GDTCS) 


TRAPGATE. - . IDT(?) 


PUBLIC MAP 


MODULE = MAIN 

PUBLIC NAME BASE 
CFUNCe. . - - LDT(2) 
MAIN. - + « - LDT(2) 
MODULE = HELP 

PUBLIC NANE BASE 
CFUNCL. . « - LDT(2) 
HELPFUNC. « - LDT(2) 
MODULE = MOD2 

PUBLIC NANE BASE 
PLMPROC . . . GDT(1) 


GDT(4) 
OFFSET 


ooo0H 
OOOAH 


EGNENT = GDTC 
DE SEGMENT 


ObH go021H 
LDT = GDT(4) 
OFFSET 
gogodd2eH 
oo00002bH 
oOoo000000H 
oooogocoH 


ogooco00H 
gooooo00H 


OFFSET 


OOO000S5BH 
gooo0000un 


OFFSET 


ogooo0CcBH 
go000070H 


OFFSET 
OO000H 


TYPE 


C FUNCTION FARLb 


DWORD 
1) 


O02FH 


TYPE 


INTEGER (4) 
INTEGER (2) 
NULL 
NULL 
NULL 
NULL 


TYPE 


OODOH 
OO4bH 


C FUNCTION INTEGER(4) NEARI2 
€ FUNCTION INTEGER(4) NEARS2 


TYPE 


WC 


C FUNCTION INTEGER(4) NEAR32 
C FUNCTION INTEGER(4) NEAR32 


TYPE 
C FUNCTION FARLb 


uc 
2 


ABSOLUTE ADDRESS 
o0003000H 


ABSOLUTE ADDRESS 


gg00S022H 

OoooSOebH 

g0003000H 

o0003000H 

oo002000H 
? 


25S 0000105BH 
255 00001000H 


ABSOLUTE ADDRESS 


255 000010CBH 
25S 00001070H 


ABSOLUTE ADDRESS 
00003000H 
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MODULE = ?DEBUG_INFO 


PUBLIC NANE BASE OFFSET TYPE WC ABSOLUTE ADDRESS O 
Bw. ee ee LDTC3) QOOO003CH INTEGER(4) O o000S03CH 
Cee eee » LDTC3) OOOOOO4OH INTEGER(2) QO OO0005040H 
PLMPROCL-. - - GDT(2) googo000H NULL = o0003000H 
PLMPROC2-. - - GDT(3) ogoogoGOH NULL = 00003000H 
TASKL « - + «© GDT(S) goooggo0H NULL = ooo0e000H 
TRAPGATE- - - IDT(?) ooooco00H NULL a ? 
TASK MAP 
TASK TSS = GDT(S) DPL = G PBIT=1 
BASE = 00002000H 

LIMIT = 000000b7H 

SSO:ESPO = 

SSL2ESP1L = 

SS2:ESP2 = 

SS:ESP = 

CS:EIP = LDT(2):00000000H 

DS = LDT(3) 

FLAGS = 00000200H 

LDTSEL SSern== 

PDR = Q0000000H 


DEBUG TRAP NOT ENABLED a) 


CROSS REFERENCE MAP FOR: TESTC2-38b 


SYMBOL NAME TYPE DEFINING MODULE REFERRING MODULE 
Bee ee ae INTEGER (4) ?@DEBUG_INFO NOD2 HEL 
Goi er os INTEGER (2) ?DEBUG_INFO MOD2 HEL 
CFUNC]L. . « s C FUNCTION INTEGER(4Y) NEAR32 HELP MAIN 
CFUNCe. «+ - C FUNCTION INTEGER(4) NEAR32 MAIN HELP 


HELPFUNC. . - C FUNCTION INTEGER(4) NEAR32 HELPS 


MAIN. » 2 se C FUNCTION INTEGER(4) NEAR32 MAINS 

PLMPROC . . - C FUNCTION FARLb Modes 

PLMPROCL. « - NULL ?DEBUG_INFO MAIN 
PLNPROC2 - . - NULL ?@DEBUG_INFO HELP 
TASK) » es - NULL ?@DEBUG_INFO3 

TRAPGATE. «. - NULL ?DEBUG_INFOS 

PROCESSING COMPLETED. O WARNINGS; O ERRORS 


Figure 4-11 Print File Example on DOS (continued) 
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6038b MAPPER 
system-id 80346 MAPPER, Vx-yVX 


INPUT FILE(S): TESTC2. 386 

INPUT OSINFO FILE: OSFILE 

OUTPUT OBJECT FILE: TESTC2-OUT 

OUTPUT PRINT FILE: TEST-MAP 

OUTPUT XREF FILE: TEST-MAP 

CONTROLS SPECIFIED: PRINT TEST-MAP. NOTYPECHECKING, PAGEWIDTH=100 
OSINFO=OSFILE OBJECTCONTROLS=(NOLINES., NOSRILINES) 


MODULES INCLUDED: 
FILE NAME MODULE NAME(S) 
TESTC2-34b MAIN HELP node ?DEBUG_INFO 


DESCRIPTOR TABLE MAP 


TABLE = GDT BASE = --------- LIMIT = OO2FH 
TABLE INDEX SELECTOR DESCRIPTOR NAME 

1 QOOBH CODE 

2 0013H PLMPROCL 

a 0018H PLMPROC2 

4 o020H LDT? 

5 o024H TASKL 
TABLE = IDT BASE = --------- LIMIT = OOF?H 
TABLE INDEX DESCRIPTOR NAME 

0 TRAPGATE 
TABLE LDT? SEQ. NO. = 1 BASE. 2+ S=Ss-84== LIMIT = 0027H 
TABLE INDEX SELECTOR DESCRIPTOR NAME 

1 ooocH LDT?: 

2 0017H CODE32 

3 OOLFH DATA 

4 o02?7H DATA 


SEGMENT MAP 


TABLE = GDT 
SEGMENT NAME TABLE INDEX PBIT USE DPL ALIGN ACCESS BASE LIMIT FIX 
CODE 1 1 USELL 3 WORD ER goo003000H 0048H Q 


Figure 4-12 Print File Example on VMS 
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TABLE = LDT? 


SEGMENT NAME TABLE INDEX PBIT USE DPL ALIGN ACCESS BASE LIMIT FIX 
CODE32 2 1 USE32 3 PARA ER 00001000H OOOOO0DAH Oo000 
DATA 3 1 USE32 3 PARA Rwd OOOOSOOOH FFFFEFFFH O0000 
DATA 4 1 USE1L 3 WORD RuD FFFF4YOLCH FFEDH is} 
LDT#: 1 1 USE1E O NONE RW. Ss4Serers5 o027H ia} 
GATE MAP 

TABLE = GDT 

GATE NAME TABLE INDEX PS8IT DPL TYPE WC SELECTOR OFFSET 

PLMPROCL 2 1 3 CALL2&b 4 GDTC(L) oggoH 

PLMPROC2 3 1 3 CALL28b 4 GDT(1) OOOOH 

TABLE = IDT 

GATE NAME TABLE INDEX PBIT DPL_ TYPE WC SELECTOR OFFSET 

TRAPGATE Qo 1 3 INTR38b --- LDT(1) ooocoH 

SYMBOL MAP 


MODULE = MAIN, LDT = GDTC4) 


SYMBOL NAME BASE OFFSET TYPE ABSOLUTE ADDRE 
A+ 6 «© » » » SS?EBP FFFFFFFEH INTEGER(2) 2 2 2 2424242 2 242 weenwnnnn 
AB. . © 6 © « LDTC(3) FFFFFFEBH INTEGER(4) QOOO4FELH 
CFUNC . - - - LDT(2) GOOOOOSBH C FUNCTION INTEGER(4) NEAR32 O0001058H 
IND: oe 2s SSTEBP QOCOOOOSH INTEGER(4Y) 2 2 2 2 2 2 2 2 22 RR nnnnee 
INe . . ~~ + SS:EBP QOOOOOOCH INTEGER(Y) 2 2 2 2 2 tenn nnnn 
MAIN. «. - « « LDT(2) Oooo0000H C FUNCTION INTEGER(Y) NEAR32 OOOOL000H 


MODULE = MAIN, CODE SEGMENT = LDT(2) 


LINE OFFSET IN CODE SEGMENT 
5 o0000000H goooodobH do000010H 
10 O00000195H O00000eFH OO000038H OoocOO44yH goo000S9SH 
15 oooooc0SBH QOOOOOSEH OOO000LLH OO0000b8H 


Figure 4-12 Print File Example on VMS (continued) 
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MODULE = MAIN 
SOURCE FILENAME = main-c 
LINE OFFSET IN SOURCE FILE 


5 googgo028H g0000033H O000003CH 
10 gooooosSEHX OOC0G0078H Gooon0s?H OOCO005DH 
1S QoO0000CSH OOOOOODESH OOOCOOEDH O000010bH 


MODULE = HELP. LDT = GDT(4) 


OOOOOO4BH 
oooo008BH 
0000010EH 


SYMBOL NANE BASE OFFSET TYPE ABSOLUTE ADDRE 
Aw... + + SS!EBP FFFFFFFEH INTEGER(2) 4 4242 ween ene 
AB ae a Hew te EDT OR) FFFFFFFLH INTEGER(4) OOOOUFFLH 
CFUNC . . . « LDT(2) DOO000CBH C FUNCTION INTEGER(4) NEAR32 OOO01L0CBH 
INL... + + SS?EBP DO000070H C FUNCTION INTEGER(4) NEAR32 --------- 
IN2. ~~... SS?EBP DOOODO08H INTEGER(Y) 2 2 2222 wenn 
MAIN. . . - - LDT(2) DOOODOOCH INTEGER(H) 2 wenn 
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Appendix A 
BND386 Error Messages 


BND386 issues a message when it encounters one of the following 
conditions: 


e WARNING: Although a questionable condition exists, the output 
object file is valid. 


e ERROR: The output object file is probably invalid even though 
BND386 processing can continue. 


e FATAL ERROR: BND386 processing aborts. All open files are 
closed. The object file created, if any, is not complete. 

Numbers that accompany the messages indicate the location of the 

exception, as follows: 

e No number: Exception is at the system interface level. 


e 100-199: Exception is in the invocation line or in an input object 
file. 


e 300-399: Exception is in internal BND386 processing. 


Messages appear in the print file and any file created with 
ERRORPRINT. Fatal error messages also appear at the console. 


This appendix provides up to four kinds of information for each 
message: 

e MEANING: how to interpret the message. 

e CAUSE: the probable reason for the message. 

e EFFECT: the state of the output file(s) and the status of BND386. 
e ACTION: suggestions for correcting the condition. 


Messages are listed in numerical order. 


A.1 


A.2 


System-Level Exceptions 


SYSTEM INTERFACE ERROR 
error text 
FILE: filename 


MEANING: This fatal error occurs in a call to the host operating 
system. The error text contains a message issued by the operating 
system. The filename is present only if the error is an I/O 
error. 


CAUSE: Such problems as an I/O error, invalid parameters, or 
insufficient memory can cause this condition. 


EFFECT: BND386 processing is aborted, and control is returned 
to the operating system. 


ACTION: Refer to host operating system documentation for 
interpretation. Correct the error and reinvoke BND386. 


Invocation or Input Object Exceptions 


ERROR 100: INPUT FILE MISSING 


MEANING: This fatal error occurs because no linkable input file 
is provided. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Specify at least one linkable input file, and then 
reinvoke. 


ERROR 101: FILENAME TOO LONG 
NEAR: token string 


MEANING: This fatal error occurs because there are too many 
characters in a filename in the invocation line near the token 
string. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Use a valid filename, and then reinvoke. 
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ERROR 102: MISSING LEFT PARENTHESIS 
NEAR: token string 


MEANING: This fatal error occurs because a left parenthesis is 
missing after the token string. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Insert a left parenthesis in the proper location, and 
then reinvoke. 


ERROR 103: MISSING RIGHT PARENTHESIS 
NEAR: token string 


MEANING: This fatal error occurs because a right parenthesis is 
missing after the token string. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Insert a right parenthesis in the proper location, and 
then reinvoke. 


ERROR 105: FILE ALREADY SPECIFIED IN COMMAND TAIL 
FILE: filename 


MEANING: This fatal error occurs because the filename is 
already specified in the input file list. One of the duplicate 
filenames is explicit in or implied by the controls. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Ensure that none of the explicit or default file names 
match, and then reinvoke. 


ERROR 106: INVALID DELIMITER IN COMMAND TAIL 
NEAR: token string 


MEANING: This fatal error occurs because the invocation line 
contains an improperly placed delimiter or uses an illegal 
character as a delimiter. The invalid delimiter is detected either 
before or after the token string. 


EFFECT: Execution aborts and control returns to the operating 
system. 
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ACTION: Use valid delimiters, including properly placed left and 
right parentheses and commas, and then reinvoke. 


ERROR 107: LINE TOO LONG IN CONTROL FILE 
FILE: filename 


MEANING: This fatal error occurs because the control file 
named by filename contains a line longer than 128 characters. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Correct the control file, making sure that all lines, 
except for comments, are less than 128 characters long, and then 
reinvoke. 


ERROR 108: TOKEN TOO LONG 
NEAR: token string 


MEANING: This fatal error occurs because the specified token 
string contains too many characters, e.g., a module name 
exceeding 40 characters. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Use a token string of valid length, and then reinvoke. 
ERROR 109: UNKNOWN CONTROL IN COMMAND TAIL 
NEAR: token string 


MEANING: This fatal error occurs because the control indicated 
in token string in the invocation line is invalid. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Spell the control correctly or use the proper 
abbreviation, and then reinvoke. 

ERROR 110: SYNTAX ERROR 

NEAR: token string 


MEANING: This fatal error occurs because the structure of the 
invocation line near token string is incorrect. 


EFFECT: Execution aborts and control returns to the operating 
system. 
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ACTION: Make sure that the information in the invocation line is 
complete, appears in the proper order, and is spelled correctly, 
and then reinvoke. 


ERROR 112: NUMBER OF SYMBOLS EXCEEDS INTERNAL LIMIT 


MEANING: This fatal error occurs because the maximum number 
of symbols BND386 can process has been exceeded. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Invoke BND386 with fewer input modules, or use 
incremental binding with the NOPUBLICS control. 


ERROR 114: INVALID OBJECT FILE 
FILE: filename 
MODULE: mod-name 


MEANING: This fatal error indicates that the mod-name 
contained in the file referred to by the file name has an invalid 
format. 


CAUSE: This condition occurs because a non-object file, such as 
a source file, or a loadable module has been specified as the input 
file. It can also occur because of an internal translator or utility 
error. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Verify that the input list specifies the correct files and 
retranslate the source files with 80286/80386 translators to create 
linkable input modules for BND386. If the problem persists, 
contact Intel. 


ERROR 115: DUPLICATE MODULE NAME 
NEAR: mod-name 


MEANING: This fatal error occurs because the specified module 
appears more than once in the input list. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Make sure that mod-name is selected only once in the 
input list, and then reinvoke. If you need both selected modules, 
pre-link one of them, changing its name with the NAME control. 
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ERROR 116: NESTED CONTROL FILES 
FILE: filename 


MEANING: This fatal error occurs because the control file 
identified by the filename contains a reference to another 
control file. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Eliminate the nesting in the control file, and then 
reinvoke BND386. 


ERROR 118: PAGE FILE OVERFLOW 


MEANING: This error occurs because an attempt was made to 
build an image greater than 8M bytes. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Rewrite your program so that it occupies less than 8M 
bytes, and then reinvoke. 


ERROR 121: MISMATCHED SEGMENT ATTRIBUTES 
FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 


MEANING: This error condition exists because segments with the 
same seg-name but with incompatible segment attributes are 
detected. The segment that triggered this error condition is in 
mod-name and filename. 


EFFECT: Processing continues, but the output object module is 
not usable. 


ACTION: Assign compatible attributes. Reinvoke BND386 with 
the adjusted input file or files. 


ERROR 122: SAME SEGMENT PLACED AT TWO DIFFERENT ENTRIES 
IN LDT 

FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 
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MEANING: This error condition occurs because duplicate 
selectors for seg-name in the input-list are detected. The 
segment whose selector caused this condition is in mod-name and 
filename. 


CAUSE: The input list may contain multiple system files (e.g., 
export modules from the system builder) that have ambiguities. 


EFFECT: Processing continues, but the output object module is 
not usable. 


ACTION: Use only the essential system files, and then reinvoke. 


ERROR 123: SEGMENT OVERFLOW DUE TO SEGSIZE VALUE 
SEGMENT: seg-name 


MEANING: This error occurs because the SEGSIZE specification 
is too large. The limit for USE16 segments is 64K bytes; the 
limit for USE32 segments is 4G bytes. 


EFFECT: Processing continues, and the output module may be 
valid; however, other errors may occur while processing fixups. 


ACTION: Ensure that the size value used in the SEGSIZE 
specification is accurate. Reinvoke if necessary. 


ERROR 124: SEGMENT UNDERFLOW DUE TO SEGSIZE VALUE 
SEGMENT: seg-name 


MEANING: This error indicates that the SEGSIZE specification 
caused the segment size to go below zero. 


EFFECT: Processing continues; however, later processing may be 
affected, e.g., when the sum of all segment sizes in input is 
calculated. 


ACTION: Use a different segment size control, and reinvoke 
BND386 if necessary. 


ERROR 125: SAME SYMBOL DEFINED TO BE IN DIFFERENT 
SEGMENTS 

FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 

SYMBOL: symbol name 
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MEANING: This error condition occurs because the specified 
symbol is defined in a segment different from the segment used 
in the public definition. The module and file containing the 
symbol name declaration are defined by mod-name and filename. 
This usually occurs because of incompatibilities in the 
segmentation models. 


EFFECT: Processing continues, but the output object module is 
invalid. The first symbol address remains effective. 


ACTION: Verify that the correct libraries for the model of 
segmentation are used. Correct the source file public-external 
declarations, retranslate, and then reinvoke. 


WARNING 126: SYMBOL TYPES MISMATCH 
FILE: filename 

MODULE: mod-name 

SYMBOL: symbol name 


MEANING: This warning condition occurs because there are two 
symbols of different types with the same name. 


EFFECT: Processing continues. 


ACTION: Set the symbols to the same type (special care must be 
taken when the modules are produced by different translators), 
recompile the modules, and then reinvoke. 


WARNING 127: DUPLICATE PUBLIC SYMBOL 
FILE: filename 

MODULE: mod-name 

SYMBOL: symbol name 


MEANING: This warning condition exists because a symbol is 
defined as public in more than one input module. The module 
containing the definition causing this warning is identified by 

mod-name, which is in filename. 


EFFECT: Processing continues, and the output is valid. The first 
instance of the public symbols remains effective for later 
processing. 


ACTION: Remove the unneeded public definition and reinvoke. 
WARNING 128: SPECIFIED MODULE NOT FOUND IN INPUT FILE 


FILE: filename 
MODULE: mod-name 
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MEANING: This warning occurs because a module is specified in 
the input list, but cannot be found in the associated file, 
identified by filename. 


EFFECT: Processing continues as if the module had not been 
specified. 


ACTION: If it is necessary to include the referenced module in 
the output module, reinvoke BND386, using a file containing the 
module. 


ERROR 129: CS REGISTER INITIALIZED BY NON-EXECUTABLE 
SEGMENT 

FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 


MEANING: This error condition occurs because a segment is not 
executable, but is identified in the main module named by mod- 
name, as the initial code segment. The module named by mod- 
name resides in filename. 


EFFECT: Processing continues, but the output object module is 
not usable. 


ACTION: Ensure that CS register initialization requirements are 
correctly specified in the input module or modules,and then 
reinvoke BND386. 


ERROR 130: SS REGISTER INITIALIZED BY NON-WRITABLE 
SEGMENT 

FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 


MEANING: This error condition occurs because seg-name is not 

' writable, but is identified in the specified main module (named 
by mod-name) as an initial stack segment. The module named by 
mod~-name resides in filename. This is almost always due to an 
invalid END directive in the assembly program. 


EFFECT: Processing continues, but the output module is 
unusable. 


ACTION: Ensure that SS register initialization requirements are 
correctly specified in the input module or modules, and then 
reinvoke BND386. 
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WARNING 131: REFERENCE TO UNRESOLVED EXTERNAL SYMBOL 
FILE: filename 

MODULE: mod-name 

REFERRING LOCATION: location 

REFERENCED LOCATION: target 


MEANING: This warning occurs when BND386 creates loadable 
output and finds reference to an unresolved external symbol in an 
input file. The target specifies the unresolved external symbol 
name. 


EFFECT: Processing continues, but the output module might not 
be usable if the loader does not resolve the external. 


ACTION: If the symbol cannot (or should not) be resolved at load 
time, reinvoke BND386, using a file that resolves the external 
reference. 


ERROR 132: REFERENCED LOCATION BEYOND LIMIT 
FILE: filename 

MODULE: mod-name 

REFERRING LOCATION: location 

REFERENCE LOCATION: target 


MEANING: This error occurs because the target information is 
not contained in the referenced segment, probably because one of 
the segment limit values is too small. The referring location is in 
mod-name and filename. 


EFFECT: Processing continues, but the output module is not 
usable. 


ACTION: Correct the size of the segment being referred to, e.g., 

by using the SEGSIZE control when you reinvoke BND386. 
WARNING 133: SEGMENT LIMIT DECREASED DUE TO SEGSIZE VALUE 
SEGMENT: seg-name 


MEANING: This warning occurs because the size of the segment 
named by seg-name is decreased because of a SEGSIZE 
specification. 


EFFECT: Processing continues, and the output module is valid. 
The user-specified value overrides the existing segment size. 


ACTION: Ensure the segment size specification is accurate, 
reinvoking BND386 if necessary to respecify the size. 
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ERROR 135: ENTRY POINT SPECIFIED IN GATE IS NON- 
EXECUTABLE 

FILE: filename 

MODULE: mod-name 

REFERRING LOCATION: location 

REFERENCE LOCATION: target 


MEANING: This error condition occurs because the entry point 
identified by target is in a nonexecutable segment. Gates are 
used to mediate access to code segments only. 


EFFECT: Processing continues, but the output module is not 
usable. 


ACTION: Reinvoke BLD386 to revise the gate and/or segment in 
the input system file or files to make the access possible; e.g., 
make the segment containing the entry point executable. 
Reinvoke BND386 using the corrected input module or modules. 


ERROR 136: ENTRY POINT SPECIFIED IN GATE IS LESS 
PRIVILEGED THAN GATE 

FILE: filename 

MODULE: mod-name 

REFERRING LOCATION: location 

REFERENCED LOCATION: target 


MEANING: This error occurs because a gate is not pointing to an 
executable entry point with a higher privilege level (numerically 
smaller) than the gate itself. 


EFFECT: Processing continues, but the output module is not 
usable. 


ACTION: Reinvoke BND386 with the correct system interface 
file, or with the correct TASKPRIVILEGE control. 


ERROR 137: BAD SELF RELATIVE REFERENCE 
FILE: filename 

MODULE: mod-name 

REFERRING LOCATION: location 
REFERENCE LOCATION: target 


MEANING: This error occurs because target and location are not 
in the same segment. The location is in mod-name in filename. 


CAUSE: This condition may be caused by a translator error or an 
erroneous ASM386 code. 
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EFFECT: Processing continues, but the output module is not 
usable. 


ACTION: Retranslate the module, and then reinvoke BND386 
with the new input file. 


ERROR 138: REFERRING LOCATION BEYOND LIMIT 
FILE: filename 

MODULE: mod-name 

REFERRING LOCATION: location 

REFERENCE LOCATION: target 


MEANING: This error occurs because the location referring to 
target is outside the limits of the segment. The location is in 
mod-name in filename. 


CAUSE: This condition may exist because the SEGSIZE control 
specified a segment size that is too small, or it may be due to a 
translator error. 


EFFECT: Processing continues, but the output module is not 
valid. 


ACTION: Retranslate the module if necessary, and then reinvoke 
BND386 using a valid SEGSIZE control specification. 


ERROR 139: CONSTANT VALUE OVERFLOW 
FILE: filename 

MODULE: mod-name 

REFERRING LOCATION: location 
REFERENCE LOCATION: target 


MEANING: This error occurs because the sum of two constant 
values, represented by a public symbol at target, and an 
incremental value in the instruction at location, cause a byte or 
word overflow, depending on the input specification. 


EFFECT: Processing continues, and the output module is valid. 
ACTION: Reassign values if required, and then reinvoke. 
ERROR 140: TEXT LENGTH IS GREATER THAN SEGMENT LENGTH 

FILE: filename 


MODULE: mod-name 
SEGMENT: seg-name 
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MEANING: This fatal error occurs because the limit of the 
segment named by seg-name is not large enough. The text may 
be an actual text item or may be represented by a fixup. The 
segment is contained in mod-name in filename. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Increase the limit of the segment, e.g., by reinvoking 
BND386 with an appropriate SEGSIZE control parameter. 


ERROR 141: CS REGISTER NOT INITIALIZED 
FILE: filename 
MODULE: mod-name 


MEANING: This error occurs because BND386 cannot find an 
initialization value for the CS register in the module named by 
mod-name in filename. This usually happens with input that 
includes ASM386 main modules, but it may also happen if the 
input does not include a main module. 


EFFECT: Processing continues, but the output module is not 
valid. 


ACTION: Include a main module or provide ASM386 CS 
initialization information, and then reinvoke. 


WARNING 142: SS REGISTER NOT INITIALIZED 
FILE: filename 
MODULE: nlod-name 


MEANING: This error occurs because the module named by 
mod-name does not contain SS register initialization information. 
This usually happens with input that includes ASM386 main 
modules; it may also happen if the input does not include a main 
module. 


EFFECT: Processing continues, but the output module is not 
valid. 


ACTION: Include a main module or provide ASM386 SS 
initialization information, and then reinvoke. 


WARNING 143: DS REGISTER NOT INITIALIZED 
FILE: filename 
MODULE: mod-name 
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MEANING: This warning occurs because the module identified 
by mod-name does not contain DS initialization information. 
This warning usually happens with input that includes ASM386 
main modules, but it may also happen if the input does not 


include a main module. oO 


EFFECT: Processing continues, but the output module is not 
usable. 


ACTION: Include a main module or provide ASM386 DS 
initialization information. and then reinvoke. 


ERROR 144: SEGMENT OVERFLOW DUE TO SEGMENT COMBINATION 
FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 


MEANING: This error occurs because the combination of 
segments identified by seg-name results in a physical segment 
larger than 64K bytes for USE16 segments, or larger than 4G 
bytes for USE32 segments. The segment causing the overflow 
condition is in mod-name. 


EFFECT: Processing continues, but the output module is not oO 
usable. Such overflow may cause errors during fixup processing. 


ACTION: Remove modules and/or segments that are not needed. 

Modify the size of the input segments or rearrange their contents. 
Use RENAMESEG to prevent unnecessary segment combination. 

Reinvoke. 


ERROR 145: TEXT FOUND IN STACK SEGMENT 
FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 


MEANING: This error occurs because the stack segment named 
by seg-name in mod-name contains text. 


EFFECT: Processing continues, but the effect on the output 


module is not known. 
ACTION: Ensure that the result is acceptable, reinvoking oO 
BND386 if necessary. 
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ERROR 146: TYPE DESCRIPTION TOO LONG 
FILE: filename 
MODULE: mod-name 


MEANING: This fatal error indicates that the type definition is 
too long and requires space that exceeds an internal limit of 
BND386. 


EFFECT: Processing is aborted, and control returns to the 
operating system. 


ACTION: Simplify the type of the symbol and retranslate. Use 
the NOTYPE control. 


WARNING 147: SEGMENT SPECIFIED IN SEGSIZE CONTROL NOT 
FOUND 
NEAR: token string 


MEANING: This warning indicates that the seg-name specified in 
a SEGSIZE control specification is not in any of the input 
modules. 


EFFECT: Processing continues, and the output module is valid. 
ie) ACTION: Use a different input list or a different SEGSIZE 
control and reinvoke BND386. 
WARNING 148: VALUE SPECIFIED IN LDTSIZE TOO SMALL 


MEANING: This warning occurs because the LDTSIZE 
specification is too small to accommodate all descriptors for the 
loadable output module. 


EFFECT: Processing continues, and the output module is valid. 
ACTION: If necessary, reinvoke BND386 using a larger value in 
the LDTSIZE control. 
WARNING 149: SEGMENT IN SEGSIZE CONTROL IS NON-WRITABLE 
SEGMENT: seg-name 


MEANING: This error occurs because seg-name is found in a 
oO SEGSIZE control specification, but the segment is not writable. 


EFFECT: Processing continues, and the output module is valid. 


ACTION: Reinvoke BND386 after changing the attribute of the 
segment, if required, using the correct SEGSIZE specification. 
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ERROR 150: INPUT HAS TWO MODULES WITH SAME NAME 
FILE: filename 
MODULE: mod-name 


MEANING: This error occurs because the input-list contains two 
modules with the same name. 


EFFECT: Processing continues, but the output module is not 
usable. 


ACTION: Eliminate the duplication of names and reinvoke. 


WARNING 151: UNRESOLVED EXTERNAL SYMBOLS 


MEANING: This warning occurs because the input contains 
references to public symbols that are not defined in the input. 


EFFECT: Processing continues, and the output module is valid. 


ACTION: If this message is not accompanied by "WARNING 131: 
REFERENCE TO UNRESOLVED EXTERNAL SYMBOL", the 
symbol is never used and the only thing you need to do is remove 
its definitions. Otherwise, when creating a loadable module, 
ensure that BND386 is invoked with input modules that contain 
public definitions for all external declarations in the input, unless 
this symbol is supposed to be resolved at load time. 


WARNING 152: PUBLIC GATE CANNOT BE EXCLUDED FROM OUTPUT 
SYMBOL: symbol name 


MEANING: This warning occurs because an attempt has been 
made to purge a public symbol associated with a gate. 


EFFECT: Processing continues, and the output module is valid. 
The public symbol is not purged. 


ACTION: Respecify the PUBLICS control to ensure that the 
public gates are not excluded from the output. 


ERROR 153: REGISTER INITIALIZED BY AN EMPTY SEGMENT 
FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 


MEANING: This error occurs because the segment identified by 
seg-name is empty. 
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EFFECT: Processing continues, but the output module is not 
valid. Message 141, 142, or 143 also appears. 


ACTION: Provide adequate initialization information in the input 
oO segments, and then reinvoke. 


ERROR 154: REFERENCED GATE IS AT HIGHER PRIVILEGE 
FILE: filename 

MODULE: mod-name 

GATE: gate name 

REFERRING LOCATION: location 

REFERENCED LOCATION: target 


MEANING: This error occurs if a reference to a gate at a higher 
privilege level (that is, numerically lower) is found in a loadable 
case. 


EFFECT: Output may not be valid. 


ACTION: Reinvoke BND386 with the correct system interface 
file, or with the correct TASKPRIVILEGE control. 


ERROR 156: MULTIPLE REGISTER INITIALIZATIONS IN INPUT 
oO FILE: filename 
MODULE: mod-name 


MEANING: This error occurs because the input list contains 
more than one main module. 


EFFECT: Processing continues, and the output module is valid. 
BND386 extracts initialization information from the first main 
module in the input. 


ACTION: Use input containing only one main module, and then 
reinvoke BND386. 


ERROR 157: REFERENCE TO SYMBOL ON STACK FOUND 
FILE: filename 
MODULE: mod-name 
REFERRING LOCATION: location 
oO REFERENCED LOCATION: target 


MEANING: This error occurs because a public symbol is defined 
to be in stack and this public symbol is referred to in a fixup. 


EFFECT: Processing continues, but BND386’s actions are 
undefined and the output module is not valid. 
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ACTION: Correct the input module, and then reinvoke BND386. 


ERROR 158: REQUIRED SLOTS IN LDT EXCEED LDT-LIMIT 


MEANING: This fatal error occurs because more than 8190 slots 
have been allocated in the LDT for the loadable output module. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Reinvoke BND386 using a different RESERVE control 
and/or fewer input segments. 


ERROR 159: REFERENCE TO AN EMPTY SEGMENT 
FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 


MEANING: This error occurs because an empty segment, 
identified by seg-name, is referred to in the input. 


EFFECT: Processing continues, but the output may not be valid. 


ACTION: Ensure that the reference is correct, reinvoking 
BND386 with different input modules if necessary. 


NOTE 


If a module contains an empty data segment and the selector 
of the segment is used as a parameter in a PUSH instruction 
(e.g., PUSH DS), the output contents may still be usable. This 
is legal if no other references to the specified segment exist. 
This case occurs by default if a main module is written in a 
high-level language (e.g., PL/M) and the module contains no 
data. Only in these specific cases may this error message be 
ignored. 


ERROR 160: SPECIFIED SLOT NUMBER IN RESERVE CONTROL TOO 
LARGE 


MEANING: This fatal error occurs because the RESERVE 
control specification contains a number larger than 8190. 


EFFECT: Execution aborts and control returns to the operating 
system. 
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ACTION: Use a RESERVE specification that specifies a number 
smaller than 8190, and then reinvoke. 


WARNING 161: SPECIFIED SYMBOL IN PUBLICS CONTROL NOT 
oO FOUND 
SYMBOL: symbol name 


MEANING: This warning occurs because BND386 cannot find 
symbol name, named in a PUBLICS control, in the input modules. 


EFFECT: Processing continues and the output module is valid. 
BND386 ignores the control referring to this symbol. 


ACTION: Ensure that the desired effect has been achieved, 
reinvoking BND386 with a different PUBLICS control 
specification if required. 


ERROR 163: NUMBER OF RESERVED RANGES BEYOND INTERNAL 
LIMIT 


MEANING: This fatal error occurs because the RESERVE control 
contains specifications for over 128 ranges. 


Oo EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Use a RESERVE control specifying fewer than 128 
ranges, and then reinvoke. 
WARNING 164: RESERVED SLOTS OVERLAP 


MEANING: This warning indicates that the RESERVE control 
specified ranges that overlap. 


EFFECT: Processing continues and the output module is valid. 
The overlapping ranges are merged into one range, consisting of 
the lowest and highest values in the overlapping ranges. 


ACTION: Ensure that the desired effect has been achieved, 
reinvoking BND386 with different RESERVE specifications if 
required. 

oO ERROR 165: NO REGISTER INITIALIZATION IN INPUT 


MEANING: This error occurs because the input contains no main 
module. 


EFFECT: Processing continues, but the loadable output module 
cannot be executed. 
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ACTION: Reinvoke BND386 using input that contains one main 
module. 


ERROR 166: INCREMENTAL BUILD INPUT FILES ARE NOT ALLOWED 
FILE: filename 


MEANING: This fatal error occurs because the file in input is an 
incrementally built file produced by BLD286/386 and cannot be 
processed by BND386. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Remove the incrementally built file from the input list. 
You may need to use an export file in the input list. Reinvoke. 


ERROR 167: OFFSET OF SYMBOL BEYOND SEGMENT LIMIT 
FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 

SYMBOL: symbol name 


MEANING: This error condition occurs because the offset of the 
specified symbol is located beyond the segment limit. 


EFFECT: Processing continues, but the output may not be usable. 


ACTION: Reposition the symbol offset and check the SEGSIZE 
control. Reinvoke. 


ERROR 168: SEGMENTS WITH COMMON ATTRIBUTE HAVE DIFFERENT 
LENGTHS 

FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 


MEANING: This error occurs because the input module contains 
FORTRAN common segments that do not have the same length. 
The module name identifies the second module containing a 
common segment. 


EFFECT: Processing continues and the output module is usable. 
The lengths of the segments remain unchanged. 


ACTION: Make the segments the same length or define them as 
blank common segments, and then reinvoke. 
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WARNING 170: SEGMENT SPECIFIED IN RENAMESEG CONTROL NOT 
FOUND 
SEGMENT: seg-name 


MEANING: This warning occurs because the segment to be 
renamed with the RENAMESEG control is not found in the input. 


EFFECT: Processing continues and the output module is usable. 


ACTION: Specify the correct seg-name in the RENAMESEG control, 
and then reinvoke. - 


ERROR 171: INVALID PRIVILEGE LEVEL 
NEAR: token string 


MEANING: This fatal error occurs because the privilege level 
specified with the TASKPRIVILEGE control is not within the range 
0 to 3. 


EFFECT: Execution aborts and control returns to the operating 
system. 


ACTION: Use a privilege level in the range 0 to 3, and then 
reinvoke. 


ERROR 172: SYMBOL TYPE INFORMATION IS TOO COMPLEX 
FILE: filename 
MODULE: mod-name 


MEANING: This error occurs because the length of the type 
definitions in the input exceeds internal limits. 


EFFECT: No type checking on these type definitions is 
performed. The output module is usable. 


ACTION: Recompile the module in filename using the NOTYPE 
control and reinvoke BND386, or reinvoke BND386 using the 
NOTYPE control. 


WARNING 174: CONFLICT IN SYMBOL SIZE REQUIREMENTS 
FILE: filename 

MODULE: mod-name 

SYMBOL: symbol name 


MEANING: This warning occurs because external symbols of the 
same name have different lengths. 


EFFECT: BND386 allocates the longer length to the symbol. 
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ACTION: Make sure multiple declarations of the same symbol 
have the same length. 


ERROR 177: INVALID USAGE OF THE RCONFIGURE CONTROL 
NEAR: token string 


MEANING: This error occurs because of invalid usage of the 
RCONFIGURE control. 


EFFECT: Processing aborts and control returns to the operating 
system. 


ACTION: Respecify the RCONFIGURE control. 


ERROR 180: FIXUP OVERFLOW 
FILE: filename 

MODULE: mod-name 
SEGMENT: seg-name 


MEANING: This error occurs because an overflow due to 
segment combination occurred during fixup. 


EFFECT: Processing continues; the fixup is not applied, and the 
output module is usable. 


ACTION: This might happen in ASM386 programs, when, for 
example, a WORD is used to hold an address of an object whose 
address is above 64K bytes. It can also happen when 16-bit 
addressing is used for such objects. The first example is 
corrected by using DWORDS. The second example is corrected by 
using 32-bit addressing. 


WARNING 181: SEGMENTS WITH DIFFERENT USE32 ATTRIBUTES 
WERE COMBINED 

FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 


MEANING: This warning occurs because an attempt was made to 
combine data or stack segments with different USE attributes. 


EFFECT: Processing continues; the combined segment has USE16 
attributes. 


ACTION: If segment must be larger than 64K bytes, use a 
different name for the segment to avoid segment combination. 
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WARNING 182: SEGMENT ACCESS RIGHTS WERE RELAXED 
FILE: filename 

MODULE: mod-name 

SEGMENT: seg-name 


MEANING: This warning occurs because the access rights of the 
specified segments were changed due to segment combinations. 
For example, when a segment that was read-only is combined 
with a segment that is writable, the new segment is writable; thus 
the protection against accidental writing is lost. 


EFFECT: Processing continues and the output module is valid. 
ACTION: If you need the original access rights, change the input 
so that the segments will not be combined. 

ERROR 183: INPUT MODULE HAS DUPLICATE SEGMENT NAMES 


MEANING: This error occurs because the specified module has 
more than one segment with the same combine name. 


EFFECT: Processing aborts and control returns to the operating 
system. 


ACTION: This is usually an error in the translator, the input 
module, or the controls used with the translator. Check the 
translation process. 


ERROR 184: 80376 DOES NOT SUPPORT USE16 CODE SEGMENTS IN 
THE INPUT OBJECT FILE 


MEANING: This error occurs because the 80376 does not 
support USE16 CODE segments in the input object file. 


EFFECT: Processing continues, but the object file is invalid. 
ACTION: Correct the source file, and then reinvoke. 
WARNING 185: SEGMENTS LARGER THAN 16 MBYTES WILL OVERLAP 
ON THE 80376. 


MEANING: This warning occurs because the MOD376 control 
was specified and, since the 80376 has a 24-bit address bus, 
addresses greater than 16 megabytes will wrap around to low 
memory. This could overlay segments that are in low memory. 


EFFECT: Processing continues, but the object file may be 
invalid. 
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ACTION: Correct the source file if necessary, and then reinvoke 
BND386. 


A.3 Internal Processing Exceptions #) 


If you encounter an error message that has the following format, 
contact Intel for assistance: 


* * * ERROR 3xx: INTERNAL PROCESSING ERROR, message 


Where: 
3xx is the error number 
message is a string containing the text of the message 


All these messages are caused by fatal errors. 
Following is the list of internal processing exceptions, along with their 
assigned numbers: 
ERROR 300: INTERNAL ERROR IN PASS1 ) 
ERROR 301: INTERNAL ERROR IN PASS2 
ERROR 302: INTERNAL ERROR IN OUTPUT 
ERROR 303: INTERNAL ERROR IN OBJECT MODULE INTERFACE 
ERROR 304: INTERNAL ERROR IN SYMBOL PROCESSING 
ERROR 305: UNKNOWN ERROR 
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Appendix B 
LIB386 Error Messages 


LIB386 issues two types of error messages: 
e Error and warning messages related to LIB386 processing 


e Messages related to the operating system interface 


All messages are sent to the current console. 


Processing Errors 


These errors are detected when LIB386 encounters an invocation error 
or an illegal input file. LIB386 processing errors also occur because 
of improper command syntax or semantics. A problem that is treated 
as a warning is any condition that could lead to an error, such as an 
empty target library. Each processing error message contains the 
following: 


e The word *** ERROR or *** WARNING 
e A unique error number 
e A brief explanation of the problem 
An error message may also contain one or more of the following items 
that describe the problem: 
- filename 
- mod-name 


- public-symbol-name 


LIB386 has two types of processing error messages: 


e  Ixx: syntax or semantic errors and object-file errors, and 
warnings 


e 3xx: internal processing errors 


Errors designated 1xx may or may not be fatal, depending on the 
particular problem. Errors designated 3xx are always fatal; these are 
internal to LIB386. You should report errors designated 3xx to an 
Intel representative. The following message is displayed for fatal 
errors: 


PROCESSING ABORTED 


This appendix provides up to three kinds of information for each 
message: 


MEANING: how to interpret the message 
EFFECT: the status of LIB386 


ACTION: suggestions for correcting the condition. Error messages 
are listed in numerical order. 


B.2  LIB386 Processing Error Messages 


ERROR 100: INVALID DELIMITER IN INVOCATION LINE 
NEAR: token 


MEANING: This error occurs because the delimiter used in the 
invocation line is not valid. Spaces and carriage returns are the 
only valid delimiters for the invocation line. 


EFFECT: Execution aborts and control is returned to the 
operating system. 


ACTION: Retype the command and then reinvoke. 
ERROR 101: UNKNOWN CONTROL IN INVOCATION LINE 
NEAR: token 


MEANING: This error occurs because an invalid control is 
specified in the LIB386 invocation line. The only valid controls 
for the LIB386 invocation line are BACKUP, NOBACK UP, 
BATCH, and NOBATCH. 


EFFECT: Execution aborts and control is returned to the 
operating system. 


ACTION: Retype the command and then reinvoke. 


B-2 LIB386 Error Messages 


ERROR 102: PATHNAME TOO LONG 
NEAR: filename 


MEANING: This error occurs because the specified filename is 
too long. A filename cannot have more than 45 characters. 


EFFECT: The command is not executed. 
ACTION: Retype the command line with a shorter filename and 
then reinvoke. 
ERROR 103: NUMBER OF SYMBOLS EXCEEDS INTERNAL PROCESSING 
LIMIT 


MEANING: This error occurs because virtual memory is not 
sufficient for the number of symbols used. 


EFFECT: Execution aborts. 
ACTION: Reduce the number of public symbols in the target 
library or allocate more memory, and then reinvoke. 

ERROR 104: PREMATURE END OF COMMAND STREAM 


MEANING: This error occurs because the command input file 
ended before the LIB386 session ended. 


EFFECT: Execution aborts. 


ACTION: In batch mode, make sure a correct QUIT command is 
present. In interactive mode, exit with a QUIT command, not a 
CTRL-Break (DOS or CTRL-Z (VMS). Reinvoke. 


ERROR 105: INVALID OBJECT FILE 
FILE: filename 


MEANING: This error occurs because the specified input file 
does not conform to the 80386 object module format 
specifications. 


EFFECT: The portion of the command pertaining to the 
offending file is not executed. 


ACTION: Verify that the file was created properly. If the file 
was improperly created, recreate the file with the appropriate 
translator or 80386 utility. Reinvoke. 
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ERROR 106: MODULE NOT FOUND 
FILE: filename 
MODULE: mod-name 


MEANING: This error occurs if the module specified in the 
command line is not in the indicated file. 


EFFECT: The portion of the command that pertains to the 
unfound module is not executed. 


ACTION: Use the LIST command to verify that the module exists 
in the specified file, and then reinvoke. 


ERROR 107: DUPLICATE MODULE 
FILE: filename 
MODULE: mod-name 


MEANING: This error occurs because the module specified to be 
added or replaced already exists in the target library. 


EFFECT: The portion of the command pertaining to the 
offending module is not executed. 


ACTION: Delete the existing module before adding the specified 
module to the library. 


ERROR 108: DUPLICATE PUBLIC 

FILE: filename 

MODULE: mod-name 

PUBLIC SYMBOL: public-symbol-name 


MEANING: This error occurs because the module specified to be 
added or replaced has a public symbol that already exists in the 
target library. 


EFFECT: The portion of the command pertaining to the 
offending public symbol is not executed. 


ACTION: Delete the existing module before adding the module 
containing the public symbol to the library. 


ERROR 109: UNABLE TO CREATE BACKUP FILE 
FILE: filename 


MEANING: This error occurs because LIB386 is unable to create 
the backup file. This can be caused if the file already exists and 
is write-protected. 


EFFECT: No backup file is created, but the session proceeds. 
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ACTION: If a backup file is desired, exit LIB386 and either 
delete or write-enable the backup file, then reinvoke LIB386. 


ERROR 110: UNABLE TO ACCESS NON-TARGET LIBRARY FILE 
FILE: filename 


MEANING: This error occurs when LIB386 is processing the 
LIST command, and LIB386 cannot open the specified file. This 
error occurs because the file does not exist or is already open. 


EFFECT: The command is not executed. 
ACTION: Check that the file is closed and exists and then 
reinvoke. 

ERROR 111: NON-TARGET FILE IS NOT A LIBRARY 

FILE: filename 


MEANING: This error occurs because an attempt was made to 
list a file that is not a library file. 


EFFECT: The command is not executed. 

ACTION: Files that are not libraries cannot be listed. 
ERROR 112: UNABLE TO CREATE LIST FILE 
FILE: filename 


MEANING: This error occurs because the LIST TO filename 
command is specified, and LIB386 is unable to create the 
filename. Probable causes are that filename is either already open 
or is an existing, write-protected file. 


EFFECT: The command is not executed. 
ACTION: Check that the file is closed and write-enabled or make 
sure that the file does not exist, and then reinvoke. 

ERROR 113: PATHNAME EXPECTED 


MEANING: This error occurs because the LIST command is 
issued at the initial command level with no filename specified. 


EFFECT: The command is not executed. 


ACTION: Specify a filename with the LIST command at the 
initial command level or initialize a library with the GET 
command, and then obtain a listing of the library. 
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WARNING 114: TARGET LIBRARY FILE IS EMPTY 


MEANING: This warning occurs because an UPDATE command is 
issued and the target library is empty. 


EFFECT: No update is performed. 
ACTION: Use the ADD command to add modules to the target 
library. 
ERROR 115: ATTEMPT TO UPDATE WRITE PROTECTED FILE 
FILE: filename 


MEANING: This error occurs because an attempt was made to 
update a file that is write protected. 


EFFECT: The UPDATE command is not executed. 

ACTION: Do not specify UPDATE, QUIT EXIT, or QUIT 

INITIALIZE for the file, or remove the write protection. 
WARNING 116: TARGET LIBRARY NOW EMPTY 


MEANING: This warning occurs because the COMPRESS command 
was specified after all modules were deleted from the target 
library. 


EFFECT: If no other modules are added, the next update 
produces an empty and invalid library file. 


ACTION: Use the ADD command to add modules to the target 
library. 

ERROR 117: INPUT FILE IS A 286 OBJECT FILE 

FILE: filename 


MEANING: An ADD or REPLACE was attempted using a 286 
object file. 


EFFECT: The file is not updated. 
ACTION: Recompile the file with a 386 translator or relink it 
with BND386, and then try again. 

ERROR 118: UNKNOWN COMMAND, TRY AGAIN 


MEANING: This error occurs because LIB386 does not 
understand the command. 


EFFECT: The command is not executed. 
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ACTION: Check the command syntax and then reinvoke. Use the 
HELP command if necessary. 


ERROR 119: MODULE OR SYMBOL NAME TOO LONG 


MEANING: This error occurs because the mod-name specified 
with the LIST command or the public symbol name specified 
with the FIND command is too long. The maximum number of 
characters is 40. 


EFFECT: The command is not executed. 


ACTION: Specify a module or symbol name that has 40 
characters or less and then reinvoke. 


ERROR 120: IMPROPER COMMAND SYNTAX 


MEANING: This error occurs because LIB386 detects a command 
syntax error. 


EFFECT: The command is not executed. 
ACTION: Check the syntax, and then reinvoke. 


ERROR 121: INPUT FILE IS NEITHER LINKABLE NOR LIBRARY 


MEANING: This error occurs because the file specified with the 
ADD or REPLACE command contains no library module or linkable 
module. Only 80386 libraries or linkable modules can be added to 
the target library. 


EFFECT: The portion of the command pertaining to the 
offending file is not executed. 


ACTION: Specify an input file that contains either linkable 
modules or a library, and then reinvoke. 


ERROR 122: COMMAND NOT ALLOWED AT CURRENT LEVEL 


MEANING: This error occurs because the command specified is 
not valid at the current command level (e.g., the initial level GET 
command is specified at the action command level). 


EFFECT: The command is not executed. 


ACTION: Use the GET or the QUIT command to return control to 
the proper command level, and then reinvoke. 


LIB386 Error Messages B-7 


ERROR 123: UNKNOWN OPTION FOR QUIT 


MEANING: This error occurs because LIB386 does not 
understand the response to the query of the QUIT command. 


EFFECT: The command is not executed. 
ACTION: Check the command syntax, and then reinvoke. 


ERROR 124: TARGET FILE IS NOT A LIBRARY 


MEANING: This error occurs because the file specified in the 
GET command is a 386 object file, but it is not a library. LIB386 
can output only libraries. 


EFFECT: The command is not executed. 
ACTION: Specify a valid, existing library file or specify a name 
for the new library file, and then reinvoke. 

WARNING 125: TARGET FILE IS WRITE-PROTECTED 


MEANING: This warning occurs because the target library file 
specified with the GET command is write-protected. 


EFFECT: The session proceeds and you can inspect the library, 
but an attempt to update the target library file will cause an 
error. 


ACTION: To make updates, write-enable the target library file. 
ERROR 126: TARGET FILE IS A 286 LIBRARY 
FILE: filename 


MEANING: An attempt was made to use GET to call a 80286 
library. 


EFFECT: The command is not executed. 
ACTION: Specify a valid, existing 80386 library file or specify a 
name for a new library file, and then reinvoke. 

ERROR 127: ATTEMPT TO LIST TO TARGET FILE 


MEANING: This error occurs because the LIST TO filename 
command is issued and filename is the name of the target library 
file. 
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EFFECT: The command is not executed. 
ACTION: Choose another filename for the LIST TO command, 
and then reinvoke. 

ERROR 128: VERSION MAY BE UP TO 4 CHARACTERS IN LENGTH 


MEANING: This error occurs because too many characters have 
been specified for the version number. 


EFFECT: The version of the library is not updated. 
ACTION: Respecify with a version of up to four characters (e.g., 
V1.0), and then reinvoke. 

ERROR 129: INTERACTIVE SET IS UNAVAILABLE IN BATCH MODE 


MEANING: An interactive SET (i.e., SET without any additional 
parameters) was specified in batch mode. 


EFFECT: The command is not executed. 


ACTION: In batch mode, specify all items you wish to set with 
their new values, using the SET command. 


B.3 System Interface Messages 


These errors may be I/O errors, illegal file name problems, or other 
problems related to the host operating system. These error messages 
have the following format: 


*** SYSTEM INTERFACE ERROR 
UDI error code and text 
FILE: filename 


Refer to the operating system reference manual for the cause of the 
problem. 
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Appendix C 
MAP386 Error Messages 


MAP386 issues a message when it encounters one of the following 
types of errors in the invocation line or a control file: 


e System interface level errors 

e Semantic and object-file errors 

e Internal processing errors 

This appendix provides up to three types of information for each 
semantic and object-file error: 

e MEANING: how to interpret the message 

e EFFECT: the status of MAP386 

e ACTION: suggestions for correcting the condition 


Messages are listed in numerical order. 


System Interface Level Errors 


If an error in a call to the host operating system is detected, MAP386 
issues a fatal error message to the console file, to the file created by 

ERRORPRINT (if open), and to the print file (if open). The error has 

the following format: 


SYSTEM INTERFACE ERROR 
error text 
FILE: filename 


The error text is operating-system dependent. The file name is 
present only if the error is an I/O error. 
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Semantic and Object-File Errors 


Messages appear in the print file and any ERRORPRINT file, if 
specified. Fatal error messages also appear at the console. 
ERROR 100: INPUT FILE MISSING 


MEANING: This fatal error occurs because no input file is 
provided in the invocation line or control file command-tail. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Reinvoke, specifying the filename of an input file. 


ERROR 101: FILENAME TOO LONG 
NEAR: token string 


MEANING: This fatal error occurs because the indicated 
filename is too long. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Reinvoke, using a shortened filename. 


ERROR 102: MISSING LEFT PARENTHESIS 
NEAR: token string 


MEANING: This fatal error occurs because a left parenthesis was 
expected, but was not found. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Reinvoke MAP386, using the expected left parenthesis. 
ERROR 103: MISSING RIGHT PARENTHESIS 
NEAR: token string 


MEANING: This fatal error occurs because a right parenthesis 
was expected, but was not found. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Reinvoke, using the expected right parenthesis. 
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ERROR 105: FILE ALREADY SPECIFIED IN COMMAND TAIL 
FILE: filename 


MEANING: This fatal error occurs because the indicated 
filename was already specified. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Reinvoke, being sure that the indicated filename is 
specified only once. 


ERROR 106: INVALID DELIMITER IN COMMAND TAIL 


NEAR: token string 


MEANING: This fatal error occurs because the indicated invalid 
delimiter was used in the invocation line or control file. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Reinvoke, using only valid delimiters. 


ERROR 107: LINE TOO LONG IN CONTROL FILE 
FILE: filename 


MEANING: This fatal error occurs because the control file 
named by filename contains a line that is too long. The 
maximum length is 128 characters. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Prepare the control file again, shortening the indicated 
line. Then reinvoke MAP 386 with CONTROLFILE, 
using the corrected filename of the control file. 


ERROR 108: TOKEN TOO LONG 
NEAR: token string 


MEANING: This fatal error occurs because the indicated token is 
too long. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Shorten the indicated token to the proper length, then 
reinvoke MAP386. 
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ERROR 109: UNKNOWN CONTROL IN COMMAND TAIL 
NEAR: token string 


MEANING: This fatal error occurs because the indicated control 
is invalid. 

EFFECT: Processing aborts, and control is returned to the 
operating system, 


ACTION: Reexamine the input, being sure that only valid 
controls (as described in Chapter 4) are used, then reinvoke 
MAP386. 


ERROR 110: SYNTAX ERROR 
NEAR: token string 


MEANING: This fatal error occurs because a mistake or 
typographical error in syntax was made. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Reexamine your input, being sure that only correct 
syntax is used, then reinvoke MAP386. 
ERROR 112: NUMBER OF SYMBOLS EXCEEDS INTERNAL LIMIT 


MEANING: This fatal error occurs because the available memory 
space is not sufficient for the number of symbols used. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Reduce the number of symbols used if you still want a 
cross-reference map, then reinvoke MAP386. 


ERROR 114: INVALID OBJECT FILE 
FILE: filename 
MODULE: mod-name 


MEANING: This fatal error occurs because the object file module 
in the input object file is invalid or is specified incorrectly. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Reconsider your input, trying to determine in what 
way the object file is invalid. Revise, then reinvoke MAP386. 
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ERROR 116: NESTED CONTROL FILES 
FILE: filename 


MEANING: This fatal error occurs because the control file 
specifies control file. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Reconstruct your input, making sure your control file 
does not refer to a second control file. Reinvoke MAP386. 
ERROR 121: PAGE WIDTH OUT OF RANGE 
NEAR: token string 


MEANING: This fatal error occurs because width is too large or 
small. The value must be between 72 and 132. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Specify a correct width value, then reinvoke MAP386. 
ERROR 122: PAGE LENGTH OUT OF RANGE 
NEAR: token string 


MEANING: This fatal error occurs because page length is too 
large or small. The value must be between 10 and 65535. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Use a correct length value, then reinvoke MAP386. 
ERROR 123: OSINFO FILE IS GREATER THAN 4K BYTES 
FILE: osinfo filename 


MEANING: This error occurs because the osinfo file is larger 
than 4K bytes. 


EFFECT: Only the first 4K bytes of the osinfo file are written 
into the osinfo section. 


ACTION: Make sure that you do not need any information that 
comes after the first 4K bytes. 
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ERROR 124: NO MODULES IN INPUT FILE FOUND 
FILE: filename 


MEANING: This fatal error occurs because the executable input 
file does not contain a module. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Correct the input file and reinvoke MAP386. 


WARNING 126: SYMBOL TYPE MISMATCH 
FILE: filename 

MODULE: mod-name 

SYMBOL: symbol name 


MEANING: This warning occurs because two symbols of the 
same name have different types. ; 


EFFECT: None—advisory information only. 
ACTION: None. 
ERROR 128: INPUT CONTAINS DUPLICATE MODULES 


FILE: filename 
MODULE: mod-name 


MEANING: This error occurs because two modules of the same 
name occur in MAP386’s input. 


EFFECT: None—advisory information only. 
ACTION: None. 


WARNING 129: EXPORTED OR UNRESOLVED EXTERNAL SYMBOLS 


MEANING: This warning occurs because external symbols found 
in MAP386’s input have no corresponding public symbol 
definition or referred-to export modules from BLD386. 


EFFECT: None—advisory information only. 
ACTION: None. 
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WARNING 130: ASSIGNING UNKNOWN DESCRIPTOR NAMES 


MEANING: This warning is issued because of unnamed 
descriptors in the input file. It is always issued for boot-loadable 
files, since there is no name information and all names are 
assigned by MAP386. For loadable files, it is issued if there is no 
name information in DESNAM. 


EFFECT: None—advisory information only. 
ACTION: None. 


ERROR 131: OVERLAPPING DESCRIPTORS IN TABLE 


MEANING: This error occurs because there is more than one 
descriptor assigned to a slot in a table. 


EFFECT: The descriptor information in the map is incorrect. 


ACTION: The build language contains an error. Correct the error 
and then reinvoke MAP386. 


WARNING 132: NO DEBUG INFORMATION IN INPUT FILE 
FILE: filename 


MEANING: This warning is issued because there is no debug 
information and consequently no information for the cross- 
reference map. 


EFFECT: There will be no information on symbols, publics or 
externals. 


ACTION: If this information is required, run BND386 or BLD386 
with the DEBUG control. 


WARNING 133: MODULE NOT FOUND IN INPUT FILE 
FILE: filename 
MODULE: mod-name 


MEANING: This warning is issued because the mod-name 
specified in the invocation line is not found in the input file. 


EFFECT: None—advisory information only. 
ACTION: None. 
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ERROR 134: MORE THAN ONE FILE FOUND WITH EXECUTABLE INPUT 
FILE: filename 


MEANING: This fatal error occurs because more than one 
executable file was specified in the invocation line. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Specify only one executable file in the invocation line, 
and then reinvoke MAP386. 
ERROR 135: EXECUTABLE FILE FOUND IN INPUT FILE LIST 
FILE: filename 


MEANING: This fatal error occurs because an executable file was 
found after one or more nonexecutable files. 


EFFECT: Processing aborts, and control is returned to the 
operating system. 


ACTION: Correct the input file list, and then reinvoke MAP386. 
ERROR 136: ERRONEOUS SYMBOL INFORMATION IN OBJECT MODULE 


FILE: filename 
MODULE: mod-name 


MEANING: This error occurs because there is an error in symbol 
debug information, nesting mismatch or missing block end. 


EFFECT: Processing continues, but there may be errors in the 
debug information. 


ACTION: None. 
WARNING 137: SYMBOL INFORMATION MISSING IN SOME MODULES 
FILE: filename 


MEANING: This warning is issued because there is no public or 
external symbol information in a linkable file. 


EFFECT: None—advisory information only. 
ACTION: None. 
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WARNING 138: PUBLIC INFORMATION MISSING IN SOME MODULES 
FILE: filename 


MEANING: This warning is issued because external symbols were 
encountered in the input to MAP386 with no corresponding 
public symbol definition. Also, no indication for unresolved 
external symbols was found. Public symbol information is 
probably missing in the input file. 


EFFECT: None—advisory information only. 


ACTION: If the information is required, find out whether 
BND386 was invoked with NODEBUG, or whether the 
information was purged. 


C.3 Internal Processing Errors 


Internal processing errors are unusual occurrences. You can not 
correct these errors. If such errors occur, you should report the 
problem to an Intel representative. 


When internal processing errors occur, the format of the error message 
is as follows: 

ERROR 3xx: INTERNAL PROCESSING ERROR, message 
The following error messages are 3xx errors. The assigned numbers 
accompany the error message. 

ERROR 300: IN OBJECT MODULE INTERFACE 

ERROR 301: IN SYMBOL PROCESSING 

ERROR 302: UNKNOWN ERROR 
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D.1 


D.2 


D.3 


This appendix is a guide to installing the RL386 software. 


Installation Media 


The RL386 software is packaged in a single 1600-BPI magnetic tape 
containing the VAX-RL386 application programs in VMS BACKUP 
format. 


Execution Environment 


The RL386 software executes on Digital Equipment Corporation 
VAX-11 models 730, 750, 780, 782, 785, and compatible models 
running under the VMS operating system release 4.1 or above. 


Installation Requirements 
Ensure that the following requirements are met before starting the 
VMSINSTAL utility: 


e SETPRY privileges, or. CMKRNL, WORLD, and SYSPRV 
privileges 


e 2500 blocks of free disk space (minimum, during installation) 
e 1300 blocks of disk space (after installation) 

e 512K bytes of physical memory 

e Approximate installation time: 15 minutes 
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Installation Procedure 


The VAX-based RL386 applications are installed using the 
VMSINSTAL utility. The installation procedure is displayed step-by- 
step on the console. The system prompts the user at each step and 
waits for user input. The user enters a response and presses <cr>. If 
there is a question about any step, the user types a question mark (7); 
an explanation is then displayed on the console. 


1. 


2 
3. 
4 


Log onto the system manager’s account. 
Ensure that the VMS system is release 4.1 or later. 
Set the default directory to SYSSUPDATE. 


Invoke the VMSINSTAL procedure giving the name of the 
product (RL386). VMSINSTAL prompts for the name of the tape 
drive (for example, MSA0O). 


A sign-on message is then displayed. 
Mount the tape on a tape drive and put the drive on line. 


A prompt then appears for the name of the directory where the 
RL386 images are to be placed. 


VMSINSTAL procedure prompts the user on whether or not to 
run the Installation Verification Procedure (IVP). 


If installation has been successful, a message stating so appears, 
and the files listed in section "RL386 Installation Files" in this 
appendix are on the target disk. 


When the above steps are completed, RL386 tools are ready to use. 


Listed below is a sample installation session on the VAX. Underlined 
text represents user input. 


Username: SYSTEM <cr> 


Password: 


<cr> 


$ SET DEFAULT SYSSUPDATE <cr> 
$ AVMSINSTAL RL386_<cr> 
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VMS Software Installation 


It is 2-AUG-1988 at 16:31. 
Enter a question mark (7?) at any time for help. 


4VMSINSTAL-W-DECNET, Your DECnet network is up and running. 
* Do you want to continue anyway [NO]? y 
* Are you satisfied with the backup of your system disk [YES]? y 
* Where will the distribution volumes be mounted [MSAO:] <tape-device> 
Please mount the first volume of the set on <tape-device> 
* Are you ready? y 
%MOUNT-I-MOUNTED, R386KT mounted on <tape-device> 
The following products will be processed: 
RL386 V1.3 

Beginning installation of RL386 V1.3 at 16:33 
% VMSINSTAL-I-RESTORE, Restoring product saveset A... 

* Installation Command Procedure for * 

* VAX/VMS RL386 V1.3 ~ 


* Do you want to purge files replaced by this installation [YES]? y 


This kit contains an Installation Verification Procedure to verify the correct 
installation of the VAX/VMS RL388 tools. 


* Do you want to run the IVP after the installation [YES]? y 
* Enter where the RL386 V1.3 images directory INTEL386 should be created: <device-name> 


4VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EASE]. 
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If you intend to execute this layered product on other nodes in your VAXcluster, and 
you have the appropriate software license, you must prepare the system-specific roots 
on the other nodes by issuing the following command on each node (using a suitable 
privileged account): 


$ CREATE /DIRECTORY SYS$SPECIFIC: [SYSHLP.EASE] 


VAX/VMS RL386 V1.3 Installation completed successfully 


%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... 


* Installation Verification Procedure for * 


eg VAX/VMS RL386 V1.3 iad 
Ware odio cacicectacemsecetadesecesdesacsenes as * 
TEST MAP386 


VAX/VMS 80386 MAPPER V1.1VX 
Copyright 1986, Intel Corporation 


PROCESSING COMPLETED. 0 WARNINGS, OERRORS 
VAX/VMS MAP386 Installation Verification completed successfully 
TEST LIB386 


VAX/VMS 80386 LIBRARIAN, V1.1VX 
Copyright 1986, Intel Corporation 


TARGET LIBRARY: NORMALIZED LIBRARY 0000 08/02/88 11:49:08 
3 MODULES ADDED, 1 MODULES DELETED 

**A LIBADD.LIB 

**D ACS 

**L TO TMP.LIS P 

**Q E 


TMP.LIB, NORMALIZED_LIBRARY 0000 08/02/88 11:49:08 
3 MODULES ADDED, 1 MODULES DELETED 


VAX/VMS LIB386 Installation Verification completed successfully 
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TEST BLD386 


VAX/VMS 80386 SYSTEM BUILDER, V1.4VX 
Copyright 1986, 1988 Intel Corporation 


© PROCESSING COMPLETED. O WARNINGS, O ERRORS 
VAX/VMS BLD386 Installation Verification completed successfully 
TEST BND386 


VAX/VMS 80386 BINDER, V1.3VX 
Copyright 1986, Intel Corporation 


PROCESSING COMPLETED. 0 WARNINGS, O ERRORS 
VAX/VMS BND386 Installation Verification completed successfully 


Installation of RL386 V1.3 completed at 16:42 


Oo VMSINSTAL procedure done at 16:43 


D.5 RL386 Installation Files 


After a successful installation, the following files will be on the target 
disk: 


1386_ EXE:MAP386.EXE 
1386_ EXE:BLD386.EXE 
1386_ EXE:LIB386.EXE 

1386 _EXE:BND386.EXE 


The installation procedure also creates the file RL386START.COM in 


the system manager’s directory SYSSMANAGER. This file should be 
part of the system start-up. 


oO D.6 RL386 Commands and the Help Facility 


The DCL commands that activate the images are integrated with the 
VMS system commands. The help text is inserted into the system 
help library. 
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D.7 Ease of Use Kit 


The following Ease of Use Kit files are installed in the directory 
SYS&ROOT: [SYSHLP.EASE]: 


APPLIC.ASM:1 Oo 


APPLIC.BLD;1 
BITCNT.C:1 
CSTART.A38;1 
FLAT.A38:1 
FLAT.BLD;1 
FLAT.COM;1 
FLATSIM.A38.1 
FLATSIM.BLD;1 
FLATSIM.COM:1 
INTPROC.ASM;1 
INTRPT.A38;1 
PROT.COM:1 
PROTFLAT.A38;1 
README.TXT;]1 
REVRS.Ci1 
SHOWBITC.INC:1 
SHOWREVR.INC;1 oO 
SIMPLE.C;1 
SIMPLE.INC;1 
SYS.ASM;1 
SYS.INC;1 
SYS1.INC;1 
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DOS Software Installation 


; This appendix is a guide to installing the 80386 utilities software on 
oO DOS systems. 


E.1 Installing the Intel386™ Family Utilities Software 
The following hardware and software is required to run the 
Intel386TM Family Utilities on DOS systems: 
e Hardware—IBM PC XT, IBM PC AT, or fully equivalent system 
e Operating system—PC-DOS version 3.3 or later 
e System memory requirements—512 K Bytes minimum RAM 


Make a backup copy of the product diskettes before installation, using 
the MS-DOS DISKCOPY program. 


To avoid name conflicts, create a directory for the 80386 software 
utilities. 
To install the software, perform the following steps: 
1. Change to the directory you have created for the software. 


2. Copy all files from each product diskette to the current directory 
with the COPY sourcedrive: *.* destdrive command. 


There are four .EXE files on the 80386 utilities diskettes: 


BLD386 
BND386 
LIB386 

MAP386 


E.1.1 Modifying the System Configuration 


Before you use the 80386 utilities, you must create or modify the 
system configuration file CONFIG.SYS so it includes the FILES and 


BUFFERS commands. Oo 


The FILES command specifies the maximum number of files that can 
be opened at the same time. The BUFFERS command specifies the 
number of disk bated in memory. 


Set the value of FILES to 12 (or greater). Set the value of BUFFERS 
to 10 (or greater). 


If there is no CONFIG.SYS file on your fixed disk, follow these steps 
to create the necessary commands: 


1. Type: 


C>copy con \config.sys <Enter> 

2. Enter the commands: 
FILES = 12 <Enter> a) 
BUFFERS = 10 <Enter> 


3. Save the file: press the F6 key or <CTRL> <Z> and then press 
Enter. 


4. Reboot the system. 
If CONFIG.SYS already exists, use an editor to add or modify the 


needed commands in the existing file. Include the commands 
FILES = 12 and BUFFERS = 10. 
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oO 80386 binder 


80386 librarian 


80386 macro 
assembler 


oO 80386 mapper 


80386 microprocessor 


80386 Software 
Oo Development Package 


80386 System Builder 


Glossary 


the 80386 program development utility used 
to link modules and/or create loadable, 
single-task output modules. Also called 
BND386. 


the interactive 80386 program development 
utility used to organize linkable modules 
into libraries and to allow existing libraries 
to be modified by adding, deleting, or 
replacing modules. Also called LIB386. 


the assembler used to produce linkable 
object modules executable on 80386 and 
80387 processors in protected mode; this 
product is part of the 80386 software 
development package. Also called ASM386. 


the 80386 program development utility used 
to generate intermodule cross-reference 
maps between public and external symbols. 
Also called MAP386. 


the 80386, an advanced, 32-bit high- 
performance microprocessor optimized for 
multiple-user and multitask systems; the 
processor has built-in virtual memory 
support and memory protection for isolating 
memory space from task to task. The 80287 
or the 80387 Numeric Processor Extension 
provides high-speed floating-point 
capabilities. 


the group of software products that make it 
possible to develop entire 80386 protected- 
mode systems containing one or more tasks. 


the system configuration utility for 80386 
protected-mode systems; this product is part 
of the 80386 Software Development 
Package. 


80386 Utilities 


absolute address 


absolute object code 


access rights 


action level 


active module 


ASM386 


attribute 


background 


base address 


based symbol 
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the 80386 binder, librarian, and mapper. 


the physical location at which code or data 
resides in memory; in protected virtual 
address mode, the 80386 processor supports 
32-bit absolute addresses. 


code or data to which absolute addresses 
have been assigned. 


the attributes that describe how a segment 
can be accessed by other segments; access 
rights for stack and data segments include 
read-only and read-write; access rights for 
code segments include execute-only, 
executable and readable, and conforming. 


the structural level at which the majority of 
LIB386 commands are available. This 
command level includes, for example, 
commands for adding, deleting, and 
replacing modules in the target library. 


when using the LIB386 utility, a module is 
designated as active if it is both logically 
and physically available. 


see 80386 Macro Assembler. 


an item defined by a descriptor: base 
address, limit, and access byte parameters; 
segment use that violates an attribute causes 
an exception or interrupt. 


the LIB386 noninteractive mode, which can 
be specified at invocation. 


the 32-bit address at which a segment starts. 


a symbol whose logical address is 
determined by a value residing at the 
address of another symbol. 


Oo 


binder 


blank common 


BLD386 


BND386 


bootloadable module 


builder 


call gate 


combine-name 


combine-type 


common 


conforming segment 


control 


see 80386 binder. 


the combine-type applied to segments 
containing unnamed FORTRAN common 
blocks. 


see 80386 System Builder. 
see 80386 binder. 


a module that contains absolute object code 
in a simple format, to expedite the loading 
of coldstart modules. BLD386 is the only 
80386 utility that can be used to create 
bootloadable modules. 


see 80386 System Builder. 


the gate used to transfer control to more 
privileged code. 


the symbolic name of a segment. During 
binding, segments with the same combine- 
name and compatible combine-types are 
combined to form a single segment. 


the attribute specifying how a segment is to 
be combined. No-combine, normal, stack, 
common, blank common, data/stack 
combined (DSC), and debug are the 
acceptable combine-types. 


the combine type associated with segments 
that contain named FORTRAN common 
blocks. 


the segment that can be shared by programs 
that execute at different privilege levels 
without using gates. 


any of several binder, librarian, or mapper 


options, each of which performs a specific 
function when used in the invocation line. 
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control file 
control transfer 
descriptors 


current privilege level 


data/stack combined 


debug information 


default value 


descriptor 


descriptor privilege 
level 
DPL 
DSC 


dynamically loadable 
module 
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the input file containing the file names of 
input files and/or controls. 


call gates, task gates, interrupt gates, and 
trap gates. 


the privilege level of a task at a specific 
instant, indicated by the CS register’s lower 
two bits and by its descriptor privilege 
level. 


the combine-type associated with segments 
created when normal data and stack 
segments that have the same combine-name 
are combined. Also called DSC. 


symbolic information used by debuggers. 
This information, which is housed in an 
object module, includes symbol names, line 
numbers, and public symbol information. 


the value assigned automatically if no value 
is specified. 


the eight-byte item that defines memory use 
in an 80386 protected-virtual-address-mode 
system. Descriptors include segment 
descriptors and system control descriptors. 


the privilege level defined in the descriptor 
for a segment or in a gate. Also called 
DPL. 


see descriptor privilege level. 
see data/stack combined. 


an executable object module created by 
BND386 or the B:F386 System Builder. The 
module can be loaded onto an 80386-based 
system running under control of an 
operating system. 


oO 


entry point 


error condition 


error message 


executable and 
readable segment 


executable file 


executable module 
executable segment 


execute-only segment 


expand-down segment 


expand-up segment 


export file 


exportation 


the code segment offset that represents the 
starting point for execution. 


a condition that causes BND386, LIB386, or 
MAP386 to issue a warning or error 
message, or that causes BND386 or MAP386 
to issue a fatal error message. 


a BND386, LIB386, or MAP386 message 
that flags a condition that may cause the 
output object module to be invalid. 


a code segment that can be read and 
executed. 


a file containing a loadable or bootloadable 
module. 


a loadable module. 
a code segment. 


a code segment that can be executed but not 
read. 


a nonexecutable segment whose limit can be 
extended toward lower-order addresses at 
run time. 


a nonexecutable segment whose limit can be 
extended toward higher-order addresses at 
run time. 


a file created with the 80386 System Builder 
containing system interface. See 
exportation. 


information placed in a file system to be 
used when creating loadable modules; this 
process makes system interface available to 
application programs. 
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extension 


external reference 


external symbol 


fatal error message 


file name 


file-spec 
file-type 


foreground 


gate 


GDT 
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a generic term for extension, used in DOS 
operating systems, and file-type, used in 
VMS operating systems. The extension is a 
period and three letter acronym added to a 
file name to identify the type of file. An 
extension is added by the user, or, in 
certain cases, by a utility if no extension is 
specified. 


a reference to a symbol, procedure, or 
location that must be defined as public in 
another module. 


an address imported by a linkable module. 
The address imported is that of a public 
symbol with the same symbolic name that 
occurs in a different module. 


a BND386 or MAP386 message that 
indicates an error condition prohibiting the 
completion of processing. The result is that 
processing aborts. 


a generic term for pathname, used in DOS 
operating systems, and file-spec, used in 
VMS operating systems. The name of a 
file. 


see file name. 
see extension. 


the interactive mode to which LIB386 
defaults. 


a descriptor used to mediate access to code 
at a higher privilege level (call gate), to 
code in a different task (task gate), or to 
interrupt service routines (interrupt or trap 
gates). 


see global descriptor table. 


oO 


generalized address 


global descriptor table 


huge data 


IDT 


illegal access 


incremental linking 


index 


initial level 


initialization 
information 


an address that has an internal name and an 
offset in the item specified by the internal 
name. 


a table that houses descriptors available to 
all tasks; this table can contain as many as 
8190 descriptors of the following types 
segment descriptors, TSS descriptors, LDT 
descriptors, call gates, and task gates. Also 
called GDT. 


a single data item that requires more 
memory than the maximum available in a 
segment. 


see interrupt descriptor table. 


an attempted code or data access that causes 
an exception condition because it violates 
hardware protection mechanisms; protection 
is implemented by enforcing segment access 
rights, page access rights, and privilege and 
descriptor usage rules. 


the process in which several linkable 
modules are merged into a single linkable 
module. The module that results from 
linking may be used as input to another 
stage of incremental linking or to final 
binding. 


the portion of a selector that points to a 
location in a descriptor table. 


the structural level at which a LIB386 
session with a new target library can begin. 


register values that must be established 
before task execution can begin. 
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internal-name 


interrupt descriptor 
table 


interrupt gate 


intersegment 
reference 


intrasegment 
reference 


LDT 


LDT selector 


LIB386 
librarian 


library 


library command 
levels 
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a fixed-length name, having as scope a 
single module. Segments, externals, types, 
gates, and descriptors all have internal 
names. 


the descriptor table that houses up to 256 
interrupt, trap, and/or task gates. It is used 
to mediate access to routines that handle 
interrupt and exception conditions. Also 
called IDT. 


the descriptor that points to an interrupt 
service routine, the use of which disables 
interrupts. 


a reference to a location in a different 
segment from the segment that contains the 
reference. 


a reference to a location in the same 
segment as the segment that contains the 
reference. 


see local descriptor table. 


a selector installed in a TSS that points to a 
particular LDT. 


see 80386 librarian. 
see 80386 librarian. 


an object library consisting of one or more 
sets of linkable modules. Object libraries 
are produced by LIB386 and reside in 
library files. 


the hierarchical structure of the LIB386 
command set. The three levels are 
operating system level, initial command 
level, and action command level. 


* 


library file 


library name 


library section 


limit 


linkable file 


linkable modules 


linking 


loadable file 


loadable module 


loader 


a file that contains a collection of linkable 
object modules indexed by module names at 
least. 


the name of a library that resides in a 
library file. 


a portion of an object library containing a 
set of linkable modules and corresponding 
directories. 


the segment attribute that defines the offset 
of the last byte in the segment. 


a file containing a sequence of linkable 
modules. Through incremental linking, 
BND386 can combine linkable modules 
produced by translators into a single 
linkable module. 


an object module created by 80386 
translators or by BND386 during 
incremental linking; a linkable module 
requires further processing before it can be 
executed. 


a process of BND386, in which segments 
from one or more linkable input modules 
are combined and references between them 
are resolved. 


a file containing a single loadable module. 
Loadable files are produced by BND386 or 
by the BLD386 System Builder. They are 
consumed by loaders, debuggers, and 
mappers. 


see dynamically loadable module. A module 
for loading onto a running system. 


a system utility that loads the user’s 


program into the system’s memory and 
initiates its execution. 
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load-time-expandable 
segment 


local descriptor table 


local symbols 


logical segment 


MAP386 
mapper 


module name 


no-combine 


non-executable file 


non-executable 
module 


non-sharable segment 
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a segment whose limit can be extended up 
or down at load time. 


a table that houses up to 8191 descriptors 
that can be private to a task; an LDT can 
contain only segment descriptors, task gates, 
and call gates. 


all symbols that are found in the SYMBOLS 
subsection of the DEBTXT section in an 
input object module. 


portions of object code that contain 
logically similar information created by 
translators. 


see 80386 mapper. 
see 80386 mapper. 


the programmer-assigned name for a 
linkable module. 


the combine-type associated with code and 
data segments that BND386 does not 
combine; these include ASM386 segments 
that are not PUBLIC, and PL/M-286 
segments compiled under the LARGE model 
of segmentation. 


an object file in a non-loadable format. 
Files in the "linkable" or "library" format. 


an object module in a non-loadable format. 
Modules in files in the "linkable" or "library" 
format. 


a segment whose access attribute is read- 
write. 


Oo 


normal 


object library 
object module format 
offset 


osinfo 


page heading 


pathname 


physical segment 


PL/M-286 


PL/M-386 


privilege hierarchy 


the combine type associated with code or 
data segments that contain ASM386 PUBLIC 
information or PL/M-286 information not 
compiled under the LARGE model of 
segmentation. 


a set of library sections. 
the structure of an object module. 
a byte address in a segment. 


the operating system information field in 
the object file. 


information placed at the top of each page, 
including product name, optional title 
string, system date and time, page number, 
and several blank lines. 


see file name. 


a contiguous piece of memory that cannot 
exceed 64 K bytes in length for USE16 
attribute or 4 gigabytes for USE32 attribute. 


the compiler used to generate 80286 
modules from source programs written in 
the high-level block-structured PL/M-286 
language. These programs can run on the 
80286 as well as on the 80386. 


the compiler used to generate 80386 
modules from source programs written in 
the high-level block-structured PL/M-386 
language. These programs can run on the 
80286 as well as on the 80386. 


an aspect of the 80386 protected-mode 
memory protection scheme that provides up 
to four different levels of access to 
segments. 
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privilege level 


privilege rules 


protected mode 


protected mode 
architecture 


protected virtual 
address mode 


protection 


public 


public definition 
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an attribute that ranges from 0 to 3 and 
controls the use of privileged instructions as 
well as access to descriptors and their 
segments; access in a protected-mode system 
uses three kinds of privilege levels current 
privilege level, descriptor privilege level, 
and requested privilege level. 


rules that govern how and when a task can 
access a segment These rules employ the 
following parameters: the type of segment to 
be accessed, the instruction used, the type 
of descriptor used, the current privilege 
level, the requested privilege level, and the 
descriptor privilege level. 


see protected virtual address mode. 


the 80386 processor configuration that 
supports virtual memory addressing and 
protection. 


the 80386 processor mode of operation that 
provides virtual memory addressing and 
memory protection; system data structures 
recognized by the processor are 
implemented in this mode. 


80386 protected-mode mechanisms ensuring 
that code and data segments are insulated 
from improper usage and that the critical 
CPU execution state control instructions are 
properly implemented. 


(1) a symbol or procedure available for 
intersegment or intrasegment references; (2) 
a kind of ASM386 segment. 


a public symbol’s translator definition. 


*) 


public symbol 


readable segment 
read-only segment 


read-write segment 


real address 


reference resolution 
relocatable 
information 


requested privilege 
level 


RPL 
run time 


section 


segment 


segment attributes 


an address exported by a linkable module. 
The address is imported by modules through 
use of an external symbol with matching 
symbolic name. 


a code segment that can be read. 
a data segment that can be read only. 


a data or stack segment that can be written 
to. 


an address that specifies an absolute location 
in memory: in 80386 protected mode, the 
real address has 32 bits. 


the process by which public definitions are 
paired with external references. 


code or data whose location is defined at 
load- or run-time. 


the privilege level defined by a selector’s 
two least-significant bits; it is used with the 
descriptor privilege level to establish the 
privilege levels a task can access. 


see requested privilege level. 

the time of program execution. 

a portion of an object module containing all 
information of a particular kind about that 
module; debug information, descriptors for 
segments and gates, program text (i.e., code 
and data), symbolic names for descriptors, 
program text, debug text, fix-ups, etc. 


see logical segment and physical segment. 


see attributes. 
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segment base 


segment descriptor 


segment limit 


segment map 


selector 


sequence number 


session 


sharable segment 


slot 


special system data 
segment descriptors 


standard output 
device 


symbol 
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the 32-bit address at which a segment 
begins. 


a descriptor referring to code, stack, and 
data segments in a program. 


the offset of the last byte in a segment. 


the BND386 print file section that provides 
information for all segments in the output 
module. 


an index into a descriptor table; GDT and 
LDT selectors are 16-bit pointers that index 
the GDT and LDT. 


a decimal number indicating the sequence 
of local descriptor tables in the GDT. 


creating a new library, and adding, 
replacing, or deleting modules to/from a 
single target library file with the LIB386 
Utility. Multiple sessions can occur 
sequentially in a single LIB386 invocation. 


a segment whose access attribute is read- 
only, execute-only, or execute-read. 


a location in a descriptor table. 


TSS and LDT descriptors. 


a generic term for console, used in DOS 
operating systems, and sys$, used in VMS 
operating systems. The system display or 
print medium. 


(1) a variable in a module; (2) an internal 
representation in BND386 of an object 
module entity. 


stack 


system builder 


system building 


system data structures 


system descriptors 


system file 


table indicator 


target library 


task 


task gate 


a combine type associated with stack 
segments. 


see 80386 System Builder. 


the configuration of a system, especially the 
selective definition of system data structures 
and tasks and the allocation of privilege 
among segments and descriptors. 


descriptor tables, segment and system 
descriptors, and task state segments. 


special system data segment descriptors and 
control transfer descriptors. 


the file that contains the information an 
operating system must have for system calls 
to be possible; in the 80386 Utilities, system 
files are linkable files created by 80386 
System Builder; they are called export files. 


a bit in a 16-bit selector that defines 
whether the selector points to the GDT or 
an LDT. 


the library file specified by LIB386 in the 
invocation line or specified in the latest 
GET library command. 


a single sequence of execution. A task has 
an associated processor state and a well- 
defined address space that has specific 
access parameters. The processor state is 
defined by the contents of the TSS; the 
address space and access parameters are 
defined by descriptors. 


a gate used to transfer control to another 
task; a task gate refers to a TSS. 
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task state segment the special system segment that stores a 
task’s initialization and restart values; the 
TSS saves a task’s entire execution state, 
e@.g., registers, address space, and a link to . 
the previous task. we) 


text program code and data. 
translator an assembler or compiler. 
trap gate a descriptor that points to an interrupt 


service routine. A trap gate does not 
disable interrupts. 


TSS see task state segment. 
TSS descriptor a descriptor that defines and points to a 
TSS. 
USE16 a segment with 32-bit attribute off. The 
segment is limited to 64K bytes. For code 
segments, the default data width and i) 


address width is 16 bits. 


USE32 a segment with 32-bit attribute on. The 
segment is limited to 4G bytes. For code 
segments, the default data width and 
address width is 32 bits. 


virtual address ; an address that contains a selector and an 
offset value. 


warning message a BND386, LIB386, or MAP386 message 
indicating that a user error may have 
occurred. The output object file is valid. 


writable segment a stack or data segment that can be written 


to. oO 
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A 
Absolute address, 4-61, 4-63, 4-65 


Access rights, 2-4, 2-5, 2-6, 2-8, 2-9, 2-10 


ACCESS, 2-77 
Action command level, 3-9, 3-10 
ADD command 
LIB386, 3-21 
Align attribute, 2-8 
ALIGN, 2-77 
Alignment types, 2-77 
ASM286, 2-6 
ASM386, 2-4, 2-6, 2-7, 2-77 


B 
BACKUP command 
LIB386, 3-24 
BACKUP control 
LIB386, 3-6 
Backup files, 3-24, 3-25 
BACKUP, 3-6 
BATCH control 
LIB386, 3-6 
BLD386, 2-1, 2-2, 2-3, 4-1, 4-6 
BND controls 
RELDESC, 2-47 
BND386 
Console messages, 2-22 
Control files, 2-17 
Controls for DOS, 2-23 
Controls for VMS, 2-23 
Debug information, 2-7, 2-58, 2-82 
Defaults, 2-21 
Error messages, 2-22, A-1 
Examples, 2-79 
Input, 2-2 
Invocation line, 2-2 
Major functions, 2-1 
Operational summary, 1-2 
Output, 2-2 
Print file, 2-2, 2-3, 2-21, 2-22, 2-23, 
2-39 


Index 


Sign-off messages, 2-22, 2-39 
Sign-on messages, 2-22 


BND386 controls 


COMPATIBLE87, 2-31 

CONTROLFILE, 2-33 

DEBUG, 2-35 

DEFAULTPAGES, 2-37, 2-47 

ERRORPRINT, 2-23, 2-39, 2-55 

FIXEDPAGES, 2-41, 2-47 
Control, 2-40 

EXCEPT, 2-57 

INT 286, 2-42 

LDTSIZE, 2-44, 2-47, 2-62, 2-66 

LOAD, 2-46, 2-62, 2-63, 2-66, 2-70 

MOD376, 2-48 

MOD386, 2-48 

NAME, 2-47, 2-50 

NOLOAD, 2-47, 2-70 

NOOBJECT, 2-52, 2-54 

NOPRINT, 2-54 

NOPUBLICS, 2-57 

NOPUBLICS EXCEPT, 2-58 

NOPURE, 2-60 

NOTYPE, 2-72 

OBJECT, 2-52, 2-55 

PRINT, 2-54 

PUBLICS, 2-57 

PUBLICS EXCEPT, 2-58 

PURE, 2-60 

RCONFIGURE, 2-46, 2-47, 2-61, 

2-62, 2-63, 2-70 

RELDESC, 2-62, 2-63 

RENAMESEG, 2-65 

RESERVE, 2-47, 2-66 

SEGSIZE, 2-68, 2-69 

TASKPRIVILEGE, 2-70 

TYPE, 2-72 


BND386 error messages, 2-22, A-1 
Bootloadable modules, 4-1 
BSS variables, 3-22 


Byte-aligned, 2-8 


Cc 
Code segments, 2-7, 2-9, 2-48, 2-77 
COMBINE NAME, 2-78 
Combine type, 2-7, 2-69, 2-77 
Command syntax 

LIB386, 3-12 
Common blocks, 2-7, 2-77 
Common segments, 2-10 
COMPATIBLES87 control 

BND386, 2-31 
COMPRESS command 

LIB386, 3-26 
Console messages 

BND386, 2-22 

LIB386, 3-7 

MAP386, 4-13 
Control files 

BND386, 2-17 

MAP386, 4-8 
CONTROLFILE control 

BND386, 2-33 

MAP386, 4-8, 4-22 
Cross-reference, 4-1, 4-4, 4-5, 4-13, 4-55 
C-386 modules, 2-80 


D 

Data segments, 2-7, 2-8, 2-9, 2-68, 2-69, 
2-77 

Data/stack combined (DSC) segments, 
2-7, 2-8, 2-42, 2-77, 2-80 

DEBUG control 
BND386, 2-35 

Debug information, 2-7, 2-58, 2-82, 4-1, 
4-5 

DEFAULTPAGES control 
BND386, 2-37 

Defaults 
BND386, 2-21 
LIB386, 3-6 
MAP386, 4-12 
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DELETE command 
LIB386, 3-27 
Descriptor names, 4-4 
Descriptor privilege level (DPL), 2-70, 
2-76, 4-4, 4-59 
Descriptor segment naming, 4-68 
Descriptor table, 2-13 
Descriptor table creation, 2-4, 2-13 
Descriptors, 2-66 
DOS invocation syntax 
BND386, 2-14 
LIB386, 3-4 
MAP386, 4-7 
DOS software installation, E-1 
DSC segment, 2-9, 2-10, 2-42 
Dynamic memory requirements, 2-61 


E 
Error messages 
BND386, 2-22, A-1 
MAP386, 4-12, 4-13, 4-14, 4-24, 4-55, 
C-1 
LIB386, B-1 
ERRORPRINT control 
BND386, 2-39 
MAP386, 4-24 
Examples 
LIB386 background session, 3-50 
BND386, 2-79 
LIB386, 3-48 
MAP386 
LIB386 multiple session, 3-50 
LIB386 single session, 3-48 
EXCEPT, 4-29, 4-30, 4-44 
Export files, 2-2 
External declaration, 2-11 
External symbols, 2-14, 2-16, 2-21, 2-35, 
2-72, 4-51, 4-53 


F 
Fatal error messages, 2-22 
Final LDT, 2-63 


Oo 


oO 


oO 


FIND command 
LIB386, 3-29 

Fix-up processing, 2-3 

FIXEDPAGES control 
BND386, 2-41 


G 

Gaps, 2-8, 2-10 

Gate map, 4-1, 4-4, 4-5, 4-13, 4-40, 4-45, 
4-46, 4-55, 4-59 

GET command 
LIB386, 3-31 

Global descriptor table (GDT), 2-13 


H 
Header, 4-55 
BND386, 2-76 
MAP386, 4-13 
HELP command 
LIB386, 3-33 
Hierarchical levels 
Action, 3-9 
Initial, 3-9 
Operating system, 3-9 


I 
IDT, 4-4, 4-57, 4-63 
Incremental linking, 2-1 
Incrementally built files, 2-2 
Initial command level, 3-9 
Input 
BND386, 2-1, 2-2 
LIB386, 3-2 
MAP386, 4-1 
Input file, 2-2 
INT286 control, 2-42 
Interface, 2-42 
Interrupt character, 3-12 
Invocation line, 3-2, 4-5 


L 
LDT, 2-13, 4-4, 4-57, 4-62, 4-63, 4-65, 
4-68 


LDT selectors, 2-67 
LDTSIZE control 
BND386, 2-44 
LIB386 
Background session, 3-50 
Command syntax, 3-12 
Console messages, 3-7 
Defaults, 3-6 
Examples 
Hierarchical levels, 3-9 
Input, 3-2 
Invocation controls, 3-6 
Major functions, 3-1 
Multiple session, 3-50 
Operational summary, 1-3 
Output, 3-2 
Prompt, 3-7 
Queries, 3-8 
Single session, 3-48 
Summary of commands, 3-12 
Transfer of levels, 3- 
LIB386 commands 
ADD, 3-21 
BACKUP, 3-24 
COMPRESS, 3-26 
DELETE, 3-27 
FIND, 3-29 
GET, 3-31 
HELP, 3-33 
LIST, 3-34 
QUIT, 3-37 
REPLACE, 3-40 
SET, 3-42 
UPDATE, 3-46 
LIB386 error messages, B-1 
LIB386 invocation controls 
BACKUP, 3-6 
BATCH, 3-6 
NOBACKUP, 3-6 
NOBATCH, 3-6 
Library files, 2-1, 2-2, 3-1, 3-2, 4-1, 4-2 
Processing, 3-2, 3-3 
LIMIT, 2-76 
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Line numbers, 4-5, 4-29, 4-31, 4-46, 4-61, 
4-63 
Linkable files, 3-21, 4-1, 4-5 
Linkable modules, 2-1, 2-2, 2-14, 2-16, 
2-59, 2-69, 4-1, 4-2, 4-3, 4-6, 4-7, 4-8 
Linkable object modules, 3-1, 3-21 
LIST command 
LIB386, 3-34 
LOAD, 2-3 
LOAD control, 2-23 
BND386, 2-46 
Loadable modules, 2-11, 2-66, 2-69, 2-76 
Local descriptor table, 2-13, 2-45 
Local descriptor table selectors, 2-66 
Local symbols, 4-4, 4-46, 4-61 
Logical address, 4-61, 4-62, 4-63, 4-65 


M 

Major functions 
BND386, 2-1 
LIB386, 3-1 
MAP386, 4-1 

MAP386 
Console messages, 4-13 
Control files, 4-8 
Controls, 4-13, 4-14 
Defaults, 4-12 
DOS invocation syntax, 4-7 
Error messages, 4-13, 4-14, 4-24 
Examples, 4-69 
Header, 4-13 
Major functions, 4-1 
Operational summary, 1-4 
Output, 4-1, 4-3, 4-4, 4-5 
Print files, 4-55 
VMS invocation syntax, 4-7 

MAP386 controls, 4-11 
CONTROLEFILE, 4-22 
ERRORPRINT, 4-24 
NOERRORPRINT, 4-24 
NOOBJECT, 4-26 
NOPAGING, 4-38 
NOPRINT, 4-40 
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NOSYMBOLSORT, 4-47 
NOTYPE, 4-50 
NOTYPECHECK, 4-51 
NOXREF, 4-53 
OBJECT, 4-26 
OBJECTCONTROL, 4-28 
OSINFO, 4-32 
PAGELENGTH, 4-34 
PAGEWIDTH, 4-36 
PAGING, 4-38 
PRINT, 4-40 
PRINTCONTROLS, 4-43 
SYMBOLSORT, 4-47 
TITLE, 4-48 
TYPE, 4-50 
TYPECHECK, 4-51 
XREF, 4-53 

MAP386 error messages, 4-12, 4-13, 
4-14, 4-24, C-1 

MOD376 control 
BND386, 2-48 

MOD386 control 
BND386, 2-48 
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